Alert History

Riwayat alert yang telah ter-trigger dari Alert Rules — review, follow-up, dan ekspor data alert masuk.

Pengenalan

Alert History adalah riwayat alert yang sudah ter-trigger secara nyata oleh sistem — yaitu event-event yang berhasil memenuhi semua kondisi yang didefinisikan dalam Alert Rule. Halaman ini berbeda dengan Event History yang menampilkan semua event dari kamera, tanpa memandang apakah event tersebut memenuhi kriteria alert atau tidak.

	Alert History	Event History
Isi	Hanya event yang lolos kondisi Alert Rule	Semua event dari stream (terlepas dari alert)
Tujuan	Review & follow-up alert masuk	Penelusuran event historis secara umum
Status follow-up	Ada (`not_followed_up` / `followed_up`)	Tidak ada
Relasi ke Rule	Selalu terikat ke satu Alert Rule	Tidak terikat ke rule

Untuk sebuah event dapat muncul di Alert History, harus ada Alert Rule yang aktif dengan kondisi yang cocok dengan event tersebut. Jika tidak ada rule yang dikonfigurasi, halaman ini akan kosong meskipun ada banyak event di Event History. Pelajari cara membuat rule di Alert Rules.

Cara Menggunakan

Melihat dan Memfilter Alert History

Buka halaman Alert History

Akses /alert-history dari sidebar Lenz Dashboard. Sistem akan otomatis memuat alert terbaru dengan urutan waktu menurun (terbaru di atas). Setiap baris di tabel menampilkan gambar event, waktu, nama Alert Rule, stream asal, tingkat keparahan, dan status follow-up.

Klik tombol Tampilkan Filter di toolbar untuk membuka panel filter di sisi kiri atau atas tampilan. Panel ini terbagi menjadi dua grup: Filter Umum dan Filter Alert.

Filter Umum:

Rentang Tanggal — pilih tanggal mulai dan tanggal akhir untuk membatasi rentang waktu alert yang ditampilkan
Cari — ketik kata kunci untuk mencari alert berdasarkan nama rule atau nama stream
Instance — pilih instance Raisa Gateway tertentu (tersedia jika Federation Mode aktif)

Filter Alert:

Aturan Alert — pilih salah satu Alert Rule untuk melihat alert dari rule tersebut saja
Tipe Peringatan — filter berdasarkan tingkat keparahan: Kritis, Tinggi, Sedang, atau Rendah
Status Follow Up — filter berdasarkan Sudah di Follow Up atau Belum di Follow Up
Stream — pilih satu atau beberapa stream; gunakan kolom pencarian untuk mencari berdasarkan nama stream atau site
Site — filter berdasarkan site, kemudian pilih stream dari site tersebut

Filter Stream hanya dapat diisi setelah Anda memilih Instance terlebih dahulu jika Federation Mode aktif. Jika tidak menggunakan federation, stream tersedia langsung.

Urutkan hasil

Gunakan dropdown Urutkan berdasarkan di toolbar untuk mengubah urutan tampilan:

Waktu — urutkan berdasarkan waktu alert dibuat (default: terbaru dulu)
Tipe Peringatan — urutkan berdasarkan tingkat keparahan alert

Lihat detail alert

Klik baris mana saja di tabel untuk membuka panel Detail Alert di sisi kanan. Panel ini menampilkan:

Gambar event yang memicu alert
Informasi dasar: nama rule, stream asal, waktu, instance
Konfigurasi Alert Rule: nama, deskripsi, analitik, tingkat keparahan, kondisi aktif
Status follow-up saat ini beserta riwayat catatan

Tandai sebagai follow-up

Di panel Detail Alert, klik tombol Tandai Sudah di Follow Up untuk mengubah status alert dari Belum di Follow Up menjadi Sudah di Follow Up. Anda dapat menambahkan catatan opsional sebelum menyimpan.

Jika perlu membatalkan, klik Batalkan Follow Up untuk mengembalikan status ke Belum di Follow Up.

Memperbarui Status Beberapa Alert Sekaligus

Pilih alert yang ingin diperbarui

Centang kotak di sebelah kiri setiap baris alert yang ingin Anda perbarui statusnya. Untuk memilih semua alert yang saat ini ditampilkan, centang kotak di header tabel (Pilih semua alert).

Setelah satu atau lebih alert dipilih, toolbar batch akan muncul di bagian bawah layar. Toolbar ini menampilkan jumlah alert yang dipilih dan kontrol berikut:

Ubah status menjadi — dropdown untuk memilih status baru: Sudah di follow up atau Belum di follow up
Kolom catatan — isi catatan yang akan diterapkan ke semua alert yang dipilih (opsional)
Terapkan — klik untuk memperbarui semua alert yang dipilih sekaligus
Hapus pilihan — batalkan seleksi

Mengekspor Data Alert History

Lenz mendukung ekspor data Alert History ke format PDF maupun Excel (XLSX). Klik tombol Ekspor di toolbar untuk membuka dialog ekspor, lalu konfigurasikan:

Format — pilih PDF atau Excel
Cakupan — ekspor hanya halaman saat ini, atau semua alert yang cocok dengan filter aktif
Sertakan Gambar — aktifkan opsi ini untuk menyertakan thumbnail gambar event di hasil ekspor (menambah ukuran file)

Ekspor dalam jumlah besar (ribuan alert) diproses di sisi server. Anda akan mendapat notifikasi ketika file siap diunduh. Jangan tutup halaman saat proses ekspor berjalan.

Fitur Utama

Filter Berlapis

Kombinasikan filter rentang tanggal, Alert Rule, tingkat keparahan, status follow-up, stream, dan site secara bersamaan untuk mempersempit hasil dengan presisi tinggi.

Follow-up Tracking

Setiap alert memiliki status follow-up yang dapat diperbarui satu per satu maupun secara batch, dilengkapi kolom catatan untuk dokumentasi tindakan yang diambil.

Detail Event Terlampir

Panel detail menampilkan gambar event asli, data stream, konfigurasi Alert Rule yang memicu, dan semua metadata event yang relevan dalam satu tampilan.

Ekspor PDF & Excel

Ekspor data dengan atau tanpa gambar ke PDF atau Excel. Pilih cakupan per-halaman atau semua data yang cocok dengan filter aktif.

Infinite Scroll & Pagination Kursor

Daftar alert dimuat secara bertahap menggunakan cursor-based pagination — halaman tidak perlu di-reload saat menggulir ke bawah untuk memuat lebih banyak data.

Federation Support

Dalam mode Federation, pilih instance Raisa Gateway tertentu untuk melihat alert dari satu deployment, atau lihat data gabungan dari semua instance.

API Reference

Halaman API Reference Lengkap

Dokumentasi interaktif OpenAPI untuk seluruh endpoint Alert History: daftar, detail, follow-up, dan ekspor.

Daftar Alert History

Mengambil daftar alert yang telah ter-trigger, dengan dukungan filter dan cursor-based pagination.

GET /api/alert-history

Autentikasi: Bearer Token atau API Key wajib disertakan di setiap request.

Contoh request

curl -X GET "https://<raisa-host>/api/alert-history?filter[follow_up_status]=not_followed_up&limit=20" \
  -H "Authorization: Bearer <access_token>"

Query Parameters

Prop

Type

Struktur Respons

Respons berhasil (200 OK)

{
  "ok": true,
  "message": "success",
  "data": [
    {
      "id": 1042,
      "alertable_id": "evt-uuid-abc123",
      "alertable_type": "event",
      "alert_rule_id": 7,
      "severity": "critical",
      "follow_up_status": "not_followed_up",
      "follow_up_notes": null,
      "created_at": "2025-04-30T08:15:00Z",
      "updated_at": null,
      "instance": null,
      "alert_rule": {
        "id": 7,
        "name": "Deteksi Wajah Tidak Dikenal",
        "description": "Alert untuk wajah yang tidak terdaftar di enrollment",
        "active": true,
        "analytic_id": "FR"
      },
      "event": {
        "id": 5801,
        "analytic_id": "FR",
        "stream_id": "stream-uuid-xyz",
        "stream_name": "Pintu Masuk Utama",
        "primary_image": "<base64-encoded-image>",
        "label": "Unknown",
        "result": "unknown",
        "event_time": "2025-04-30T08:14:58Z",
        "created_at": "2025-04-30T08:14:59Z"
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "has_next": true,
    "has_prev": false,
    "next_cursor": "cursor_eyJpZCI6MTAzMH0",
    "prev_cursor": null,
    "total": null
  }
}

Field Respons Penting

Prop

Type

Ambil Detail Alert Tunggal

GET /api/alert-history/:id

Mengambil detail lengkap satu alert berdasarkan ID.

Contoh request

curl -X GET "https://<raisa-host>/api/alert-history/1042" \
  -H "Authorization: Bearer <access_token>"

Respons memiliki struktur yang sama dengan satu item di dalam array data pada endpoint daftar, dengan wrapper:

Struktur respons detail

{
  "ok": true,
  "message": "success",
  "data": { /* AlertHistoryItem */ }
}

Perbarui Status Follow-up

PATCH /api/alert-history/:id/follow-up-status

Mengubah status follow-up satu alert beserta catatan opsional.

Contoh request

curl -X PATCH "https://<raisa-host>/api/alert-history/1042/follow-up-status" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "follow_up_status": "followed_up",
    "follow_up_notes": "Sudah diperiksa oleh tim keamanan pukul 09.00 WIB"
  }'

Request Body

Prop

Type

Respons berhasil

{
  "ok": true,
  "message": "follow up status updated successfully"
}

Alert History

Pengenalan

Cara Menggunakan

Melihat dan Memfilter Alert History

Buka halaman Alert History

Tampilkan panel filter

Urutkan hasil

Lihat detail alert

Tandai sebagai follow-up

Memperbarui Status Beberapa Alert Sekaligus

Pilih alert yang ingin diperbarui

Mengekspor Data Alert History

Fitur Utama

Filter Berlapis

Follow-up Tracking

Detail Event Terlampir

Ekspor PDF & Excel

Infinite Scroll & Pagination Kursor

Federation Support

API Reference

Halaman API Reference Lengkap

Daftar Alert History

Query Parameters

Struktur Respons

Field Respons Penting

Ambil Detail Alert Tunggal

Perbarui Status Follow-up

Request Body

Tips & Troubleshooting

Selanjutnya

Alert Rules

Notification Channels

Event History

On this page

Alert History

Filter Berlapis

Follow-up Tracking

Detail Event Terlampir

Ekspor PDF & Excel

Infinite Scroll & Pagination Kursor

Federation Support

Halaman API Reference Lengkap

Alert tidak muncul padahal event terlihat di Event History

Jumlah alert di halaman ini berbeda dengan notifikasi yang diterima

Tombol 'Tandai Sudah di Follow Up' tidak aktif

Ekspor gagal atau menghasilkan file kosong

Kolom 'Stream' di filter tidak menampilkan pilihan

Cara membaca field 'alertable_type' di respons API

Alert Rules

Notification Channels

Event History

On this page