Audit Logs
Rekam jejak aktivitas sistem secara menyeluruh — lacak siapa yang melakukan apa, kapan, dan dari mana, untuk kebutuhan compliance, keamanan, dan investigasi internal.
Pengenalan
Audit Logs adalah catatan aktivitas sistem yang direkam secara otomatis setiap kali pengguna atau sistem berinteraksi dengan API platform Visionaire. Setiap permintaan yang masuk dicatat lengkap dengan identitas pengguna, waktu permintaan, metode HTTP, resource yang diakses, alamat IP, kode status respons, dan durasi eksekusi.
Halaman ini dirancang untuk administrator dan auditor yang membutuhkan visibilitas penuh atas seluruh aktivitas yang terjadi di sistem — baik untuk keperluan kepatuhan regulasi, investigasi insiden keamanan, maupun pemantauan pola akses yang tidak wajar.
| Audit Logs | Event History | |
|---|---|---|
| Subjek catatan | Setiap permintaan API ke sistem | Setiap event deteksi AI dari kamera |
| Tujuan utama | Compliance, audit trail, keamanan akses | Penelusuran aktivitas kamera secara historis |
| Informasi pengguna | Nama, User ID, IP address, metode HTTP | Tidak ada (event berasal dari mesin AI) |
| Cakupan | Seluruh endpoint API yang diakses | Terbatas pada event deteksi yang dihasilkan AI |
Akses ke halaman Audit Logs memerlukan permission AUDIT_LOG. Jika halaman tidak dapat diakses, hubungi administrator untuk memeriksa konfigurasi role Anda.
Cara Menggunakan
Menelusuri Audit Log
Buka halaman Audit Logs
Akses /audit-logs dari sidebar Lenz Dashboard. Sistem akan otomatis menampilkan tabel log dengan rentang tanggal hari ini sebagai filter default. Setiap baris di tabel menampilkan waktu permintaan, pengguna, metode HTTP, resource yang diakses, alamat IP, kode status, dan durasi eksekusi.
Filter berdasarkan pengguna
Gunakan kolom pencarian Search di panel filter untuk menemukan aktivitas dari pengguna tertentu. Anda dapat mengetikkan nama pengguna, alamat email, atau User ID. Sistem akan menampilkan seluruh log yang terkait dengan pengguna tersebut sesuai rentang tanggal yang aktif.
Filter berdasarkan tipe aksi (Method)
Pilih metode HTTP dari dropdown Method untuk mempersempit log berdasarkan jenis operasi:
- GET — operasi baca data (melihat daftar, detail, ekspor)
- POST — operasi pembuatan data baru (tambah pengguna, enrollment, konfigurasi)
- PUT / PATCH — operasi pembaruan data yang sudah ada
- DELETE — operasi penghapusan data
Pilih Semua untuk menampilkan log dari semua metode sekaligus.
Filter berdasarkan resource
Gunakan dropdown Resource untuk mempersempit log berdasarkan modul atau endpoint yang diakses, misalnya user, stream, enrollment, audit-log, dan lainnya. Ini berguna saat Anda ingin memfokuskan investigasi pada satu domain tertentu.
Tentukan rentang waktu
Klik field Rentang Tanggal untuk membuka date picker. Pilih tanggal mulai dan tanggal akhir yang diinginkan. Secara default, sistem menampilkan log untuk hari ini saja (00:00 – 23:59). Untuk keperluan audit jangka panjang, Anda dapat memperluas rentang hingga beberapa minggu atau bulan.
Semua filter yang Anda terapkan tersimpan di URL halaman. Anda dapat menyalin URL dan membagikannya kepada rekan tim atau menyimpannya sebagai bookmark untuk akses cepat di kemudian hari.
Filter berdasarkan status respons
Gunakan dropdown Status untuk memfilter log berdasarkan kode respons HTTP:
- 2xx (Berhasil) — permintaan berhasil diproses oleh sistem
- 4xx (Kesalahan Klien) — permintaan ditolak karena data tidak valid, tidak terautentikasi, atau tidak memiliki izin
- 5xx (Kesalahan Server) — terjadi kesalahan di sisi server saat memproses permintaan
Filter ini sangat berguna untuk mendeteksi percobaan akses yang gagal atau anomali keamanan.
Tipe Aksi yang Dicatat
Semua permintaan API ke platform Visionaire dicatat secara otomatis. Berikut adalah kategori aksi utama yang akan Anda temukan di Audit Logs:
Manajemen Pengguna
Pembuatan, pembaruan, penghapusan akun pengguna, perubahan role dan permission, serta reset password.
Autentikasi
Login, logout, pembuatan dan pencabutan API Key, serta refresh Token sesi.
Enrollment Wajah & Kendaraan
Penambahan, pembaruan, dan penghapusan data enrolled face atau kendaraan dari database.
Manajemen Stream & Kamera
Konfigurasi stream kamera, penambahan NVR, perubahan pengaturan site, dan pengaturan alert.
Pencarian & Deteksi
Operasi Face Search, plate search, dan akses ke riwayat event yang dihasilkan sistem AI.
Konfigurasi Sistem
Perubahan preferensi sistem, pengaturan notifikasi, konfigurasi retensi data, dan pengaturan federation.
Fitur Utama
Filter Multi-Dimensi
Saring log berdasarkan kombinasi pengguna, metode HTTP, resource, status respons, dan rentang waktu secara bersamaan untuk investigasi yang presisi.
URL Shareable
Semua parameter filter tersimpan di URL, memudahkan berbagi konteks investigasi dengan anggota tim lain atau menyimpan konfigurasi filter tertentu.
Paginasi Adaptif
Tampilkan 10, 25, 50, atau 100 baris per halaman sesuai kebutuhan. Posisi halaman dan ukuran halaman juga tersimpan di URL.
Federation Support
Pada deployment dengan Federation Mode aktif, filter tambahan Instance tersedia untuk menelusuri log dari node Raisa Gateway tertentu.
Informasi Durasi
Setiap log mencatat durasi eksekusi permintaan dalam milidetik, berguna untuk mendeteksi operasi yang tidak normal atau terlalu lambat.
Konteks Pengguna Lengkap
Setiap entri log menyertakan informasi pengguna yang terasosiasi — nama, email, User ID — sehingga akuntabilitas dapat ditegakkan secara akurat.
API Reference
Dokumentasi lengkap endpoint Audit Logs tersedia di halaman terpisah, lengkap dengan skema request/response interaktif dan contoh payload.
Format Log Entry
Setiap entri Audit Log menyimpan informasi berikut dalam struktur data standar:
{
"id": 1042,
"user_id": 7,
"ip_address": "192.168.1.45",
"method": "POST",
"resource": "enrollment",
"path": "/api/enrolled-faces",
"status_code": 201,
"request_time": "2026-04-30T08:22:11.504Z",
"duration": 312,
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"content_type": "application/json",
"created_at": "2026-04-30T08:22:11.800Z",
"user": {
"id": 7,
"email": "admin@example.com",
"username": "admin",
"fullname": "System Administrator",
"avatar": "",
"role_id": "2"
}
}Penjelasan Field:
Prop
Type
Tips & Troubleshooting
Selanjutnya
Pelajari fitur audit trail lainnya yang melengkapi Audit Logs untuk visibilitas sistem yang lebih menyeluruh:
Face Search Logs
Rekam jejak khusus untuk setiap operasi pencarian wajah — lacak pengguna, metode pencarian, gambar yang digunakan, dan hasil yang dikembalikan.
Plate Search Logs
Rekam jejak operasi pencarian plat kendaraan — pantau siapa yang melakukan pencarian plat, kapan, dan kendaraan apa yang ditemukan.