Face Search Logs
Audit trail aktivitas pencarian wajah — lacak siapa, kapan, dan dengan foto apa setiap Face Search dilakukan untuk keperluan compliance dan investigasi internal.
Pengenalan
Face Search Logs adalah audit trail lengkap dari setiap operasi pencarian wajah yang dilakukan melalui platform Visionaire. Setiap kali pengguna atau sistem menjalankan Face Search — baik pencarian kandidat, pencocokan anonim, pencarian demografi, maupun pencarian NIK lokal — sistem secara otomatis mencatat identitas pemohon, waktu, metode pencarian, alamat IP, gambar yang digunakan, dan status respons API.
Halaman ini dirancang untuk administrator dan auditor yang membutuhkan visibilitas penuh atas penggunaan fitur pencarian wajah, baik untuk kepatuhan regulasi, investigasi insiden, maupun pemantauan pola akses yang tidak wajar.
| Face Search Logs | Event History | |
|---|---|---|
| Subjek catatan | Setiap permintaan Face Search yang masuk ke API | Setiap event deteksi AI dari kamera |
| Tujuan utama | Compliance, audit trail, investigasi akses | Penelusuran aktivitas kamera secara historis |
| Informasi pengguna | Nama, User ID, tipe autentikasi, IP address | Tidak ada (event berasal dari mesin AI) |
| Gambar permintaan | Gambar query yang diunggah pengguna | Gambar tangkapan kamera |
Akses ke halaman Face Search Logs memerlukan permission FACE_SEARCHING_LOGS. Jika halaman tidak dapat diakses, hubungi administrator untuk memeriksa konfigurasi role Anda.
Cara Menggunakan
Menelusuri Log Pencarian Wajah
Buka halaman Face Search Logs
Akses /face-search-logs dari sidebar Lenz Dashboard. Sistem akan otomatis menampilkan tab Log dengan data hari ini sebagai rentang tanggal default. Setiap baris di tabel menampilkan waktu, pengguna, metode pencarian, alamat IP, sumber, status, dan tautan ke detail permintaan.
Terapkan filter yang diinginkan
Gunakan panel filter di bagian atas tabel untuk mempersempit data yang ditampilkan. Filter yang tersedia:
- Rentang Tanggal — pilih tanggal mulai dan tanggal akhir untuk membatasi periode log yang ditampilkan. Secara default diisi dengan hari ini (00:00 – 23:59).
- Metode Pencarian — filter berdasarkan jenis operasi yang dilakukan:
- Semua Metode — tampilkan semua jenis pencarian
- Pencarian Kandidat — operasi
face-search-candidates(mencari kecocokan wajah) - Pencocokan Anonim — operasi
match-anonymous(membandingkan dua wajah tanpa enrollment) - Pencarian Demografi — operasi
face-search-demography(cari data kependudukan) - Pencarian NIK Lokal — operasi
local-nik-search(pencarian berbasis NIK)
- Status — filter berdasarkan kode respons HTTP:
- Berhasil (200) — permintaan berhasil diproses
- Kesalahan Klien (400) — permintaan tidak valid atau ditolak
- Kesalahan Server (500) — terjadi kesalahan di sisi server
- Sumber — filter berdasarkan asal permintaan: Manual (dilakukan oleh pengguna) atau Otomatis (dilakukan oleh sistem/integrasi).
- Alamat IP — ketik alamat IP tertentu untuk melihat log dari sumber jaringan tertentu.
- Instance — pilih instance Raisa Gateway tertentu (tersedia jika Federation Mode aktif).
Filter Rentang Tanggal dan Metode Pencarian berlaku di kedua tab (Log dan Statistik) secara bersamaan. Mengubah salah satu filter di tab Log akan otomatis memperbarui tab Statistik, dan sebaliknya.
Lihat detail permintaan
Klik baris mana saja di tabel untuk membuka panel Detail Log Pencarian Wajah. Panel ini menampilkan informasi lengkap:
- Data Permintaan — gambar query yang diunggah, metode pencarian, waktu, status, dan alamat IP pemohon
- Informasi Pengguna — nama pengguna, User ID, tipe autentikasi (Token/API Key), dan nama API key jika menggunakan API key
- Data Respons — hasil pencarian termasuk kandidat wajah yang ditemukan, data demografi, atau hasil pencocokan (bergantung pada metode pencarian)
- Detail Perbandingan — untuk operasi pencocokan wajah, panel menampilkan wajah referensi dari database dan gambar yang diunggah, disertai tingkat kemiripan dan kategori hasilnya (Kecocokan Tinggi, Sedang, atau Rendah)
Analisis statistik penggunaan
Klik tab Statistik di bagian atas halaman untuk beralih ke tampilan ringkasan. Tab ini menyajikan:
- Ringkasan — total pencarian, jumlah berhasil, jumlah gagal, dan tingkat keberhasilan dalam periode yang dipilih
- Distribusi Status — proporsi respons 200, 400, dan 500 dalam bentuk visual
- Akses Pengguna — daftar pengguna yang paling banyak melakukan pencarian, diurutkan berdasarkan jumlah akses tertinggi
Ekspor log ke PDF
Untuk keperluan pelaporan atau dokumentasi audit, klik tombol Ekspor ke PDF di toolbar tabel. Sistem akan menghasilkan file PDF berisi seluruh log yang sedang ditampilkan pada halaman aktif, lengkap dengan kolom waktu, permintaan, metode pencarian, alamat IP, dan pengguna.
Ekspor PDF hanya mencakup data pada halaman yang sedang aktif, bukan keseluruhan hasil yang cocok dengan filter. Pastikan ukuran halaman (jumlah baris) sudah sesuai sebelum mengekspor.
Fitur Utama
Audit Trail Lengkap
Setiap permintaan Face Search dicatat secara otomatis mencakup identitas pengguna, waktu, alamat IP, metode pencarian, gambar query, dan hasil respons — tidak ada aktivitas yang terlewat.
Filter Multi-Dimensi
Kombinasikan filter rentang tanggal, metode pencarian, status HTTP, sumber permintaan, dan alamat IP secara bersamaan untuk mempersempit hasil investigasi dengan presisi tinggi.
Detail Permintaan & Respons
Panel detail menampilkan gambar query yang diunggah, data respons lengkap (kandidat wajah, data demografi, atau hasil pencocokan), serta informasi autentikasi pengguna.
Tab Statistik Terintegrasi
Tampilan statistik menunjukkan tingkat keberhasilan, distribusi status respons, dan daftar pengguna paling aktif — berguna untuk mendeteksi anomali penggunaan.
Sinkronisasi Filter Antar-Tab
Filter rentang tanggal dan metode pencarian otomatis tersinkronisasi antara tab Log dan tab Statistik, sehingga konteks analisis tetap konsisten saat berpindah tampilan.
Ekspor PDF
Hasilkan laporan PDF dari log yang ditampilkan untuk keperluan dokumentasi audit, pelaporan compliance, atau arsip investigasi internal.
Federation Support
Dalam mode Federation, pilih instance Raisa Gateway tertentu untuk mengaudit aktivitas Face Search dari satu deployment spesifik, atau bandingkan antar-instance.
URL-Persisted Filters
Semua filter dan parameter halaman tersimpan di URL secara otomatis — bagikan tautan ke kolega atau simpan sebagai bookmark untuk membuka kembali hasil yang sama kapan saja.
API Reference
Dokumentasi endpoint lengkap (parameter query, schema respons, contoh request/response, dan kode status) tersedia di halaman terpisah:
Tips & Troubleshooting
Selanjutnya
Face Search
Lakukan pencarian wajah secara langsung menggunakan gambar atau foto untuk menemukan kandidat yang cocok dari database enrollment.
Face Enrollment
Kelola database wajah yang digunakan sebagai referensi untuk operasi Face Search — tambah, perbarui, dan hapus data enrollment.
Plate Search Logs
Audit trail aktivitas pencarian plat nomor kendaraan — mekanisme yang sama dengan Face Search Logs namun untuk operasi LPR.