Event History
Telusuri, filter, dan ekspor seluruh riwayat event deteksi AI — Face Recognition, LPR, People Analytics, Vehicle Analytics, dan lainnya — beserta referensi API lengkap.
Pengenalan
Halaman Event History (/event-history) menyimpan seluruh riwayat event deteksi yang pernah dihasilkan oleh Visionaire AI Engine. Berbeda dengan halaman Live Events yang menampilkan deteksi secara streaming real-time, Event History berfokus pada data yang sudah tersimpan di database dan dapat diakses kembali kapan saja.
| Aspek | Live Events | Event History |
|---|---|---|
| Sumber data | WebSocket (push) | REST API (pull) |
| Rentang waktu | Saat ini (real-time) | Historis (dapat dipilih) |
| Filter waktu | Tidak tersedia | Tersedia — per menit, jam, hari, atau rentang kustom |
| Export | Tidak tersedia | PDF dan Excel |
| Penggunaan utama | Monitoring aktif | Investigasi insiden, pelaporan, audit |
Event History merekam semua tipe analitik yang aktif pada pipeline Anda: Face Recognition (NFV4-FR/FRA), License Plate Recognition (NFV4-LPR/LPR2/LPR3), People Analytics (NFV4-MPA/MPAA/MPA2), Vehicle Analytics (NFV4-MVA/MVAA), dan Crowd Estimation (NFV4-CE).
Cara Menggunakan
Mengatur Filter Waktu
Buka halaman Event History
Akses /event-history dari sidebar. Secara default, halaman menampilkan event hari ini dari pukul 00:00 hingga 23:59 di timezone browser Anda.
Klik area pemilih tanggal (Date Range)
Klik field Rentang Tanggal di toolbar untuk membuka kalender. Pilih tanggal mulai dan tanggal selesai. Rentang maksimum tidak dibatasi secara UI, namun performa query dapat menurun untuk rentang lebih dari 30 hari dengan volume data besar.
Konfirmasi rentang
Setelah memilih kedua tanggal, klik Terapkan Filter untuk memperbarui tabel. Parameter yang dikirim ke API adalah filter[timestamp_from] dan filter[timestamp_to] dalam format ISO 8601 dengan timezone offset (2024-01-15T00:00:00+07:00).
Menggunakan Filter Tipe Analitik
Buka panel Filter Lanjutan
Klik tombol Filter Lanjutan di toolbar untuk membuka panel filter. Di sini Anda dapat memilih satu atau lebih tipe analitik sekaligus.
Pilih tipe deteksi
Pada bagian Tipe Deteksi, centang analitik yang ingin Anda tampilkan. Anda dapat memilih beberapa analitik secara bersamaan, misalnya NFV4-FR dan NFV4-LPR dalam satu query.
(Opsional) Atur sub-filter Status/Logika
Setelah memilih analitik, panel akan memunculkan sub-filter yang relevan secara otomatis:
- Analitik pengenalan (FR, FRA): sub-filter Status —
KNOWN(dikenal),UNKNOWN(tidak dikenal),ANONYMOUS(anonim) - Analitik multi-logika (MVA, MPA, MPAA, MVAA): sub-filter Logika —
counting,dwelling,density - Analitik umum (LPR, CE): sub-filter Deteksi — nilai status generik
Saat Anda memilih beberapa analitik dari kategori berbeda (misalnya FR dan MVA), panel akan menggabungkan opsi Status dan Logika secara tersegmentasi agar tidak terjadi konflik.
Klik "Terapkan Filter"
Klik tombol Terapkan Filter untuk memperbarui tabel. Filter yang aktif akan terlihat di panel Filter Aktif di atas tabel.
Menggunakan Filter Site dan Stream
Buka selector Kamera
Klik tombol Kamera di toolbar. Akan muncul daftar stream yang tersedia, dikelompokkan berdasarkan site.
Cari atau pilih stream
Gunakan kotak pencarian untuk menyaring berdasarkan nama stream atau site. Centang satu atau beberapa stream yang ingin Anda tampilkan. Jika ingin menampilkan semua stream dari satu site, centang nama site-nya.
Terapkan pilihan
Klik Selesai atau Terapkan Filter. Parameter filter[stream_id] akan diisi dengan ID stream yang dipilih, dipisahkan koma jika lebih dari satu.
Melihat Detail Event
Klik baris event di tabel
Klik salah satu baris pada tabel untuk membuka dialog Detail Event. Dialog ini menampilkan gambar utama dan gambar sekunder dari event tersebut.
Navigasi tab Detail dan Playback
Dialog memiliki dua tab:
- Detail — menampilkan atribut event: timestamp, analitik, lokasi, hasil deteksi, status, dan data pipeline mentah (face_id, plate_number, confidence, dan seterusnya)
- Playback — memutar ulang rekaman video sekitar 45 detik sebelum timestamp event, total durasi 90 detik (memerlukan NVR yang terhubung)
Tutup dialog
Klik di luar dialog atau tekan tombol Esc untuk menutup.
Export PDF dan Excel
Export berjalan secara asinkron di sisi server. Lenz akan memulai job export, memantau progresnya, dan mengunduh file secara otomatis saat selesai. Pastikan tidak menutup tab browser selama proses berlangsung.
Pastikan filter sudah diatur
Sebelum export, pastikan filter waktu, tipe analitik, dan stream sudah sesuai dengan data yang ingin Anda ekspor. Export akan mengikuti filter yang aktif saat ini.
Klik tombol "Ekspor"
Klik tombol Ekspor di toolbar. Pilih format:
- Ekspor ke PDF — menghasilkan file PDF landscape berformat tabel dengan kolom: Gambar, Tanggal, Analitik, Lokasi, Status, Hasil
- Ekspor ke XLSX — menghasilkan file Excel dengan kolom yang sama, termasuk gambar event yang disematkan di dalam sel
Pilih cakupan export
Setelah memilih format, pilih cakupan:
- Halaman ini saja (
current_page) — hanya mengekspor data pada halaman saat ini - Semua data (
all) — mengekspor seluruh data sesuai filter aktif
Untuk cakupan Semua data, sistem akan memulai job asinkron di server (POST /api/event-history/{category}/export). Progress akan ditampilkan dan file akan diunduh otomatis saat status berubah menjadi completed.
Tunggu hingga selesai
Lenz akan menampilkan indikator progress. Setelah selesai, file akan terunduh otomatis ke folder unduhan browser Anda dengan nama seperti event-history.pdf atau event-history.xlsx.
Fitur Utama
Filter Multi-dimensi
Saring event berdasarkan rentang waktu, tipe analitik, stream, site, status pengenalan, logika deteksi, dan Face ID — semua dapat dikombinasikan sekaligus.
Tabel Terkelompok per Tanggal
Event dikelompokkan otomatis berdasarkan tanggal untuk memudahkan navigasi kronologis saat investigasi insiden.
Detail Event Lengkap
Setiap event menampilkan gambar deteksi, data pipeline mentah (confidence, face_id, plate_number, atribut, dan lainnya), serta playback video jika NVR tersedia.
Export PDF dan Excel
Export data ke PDF atau Excel dengan gambar event disematkan. Export asinkron di sisi server mendukung volume data besar tanpa memblokir browser.
Pagination dan Pengurutan
Navigasi data dengan pagination server-side, pilih jumlah data per halaman, dan urutkan berdasarkan waktu terbaru atau terlama.
Timeline Distribution
Visualisasi distribusi jumlah event per interval waktu untuk mengidentifikasi pola atau lonjakan aktivitas di periode tertentu.
API Reference
Dokumentasi lengkap seluruh endpoint Event History tersedia di halaman dedicated berikut, mencakup skema request/response lengkap dan contoh interaktif.
API Reference — Event History
Daftar event, detail, timeline distribution, export asinkron (inisiasi, status, unduh, batalkan), dan administrasi data.
Otentikasi
Cara memperoleh Bearer token JWT dan API Key untuk mengakses endpoint.
Tips dan Troubleshooting
Selanjutnya
Live Events
Pantau event deteksi AI secara real-time melalui WebSocket tanpa perlu refresh halaman.
Statistik
Analitik performa dan agregasi data historis per tipe analitik: FR, LPR, People Analytics, Vehicle Analytics.
Face Search
Cari kecocokan wajah di seluruh riwayat event berdasarkan gambar atau Face ID.