Nodeflux Central
Plate Search Logs

Plate Search Logs

Audit trail aktivitas pencarian plat kendaraan — siapa mencari apa, kapan, dari mana, dan dengan hasil apa. Lengkap dengan statistik penggunaan dan referensi API.

Pengenalan

Halaman Plate Search Logs (/plate-search-logs) adalah audit trail terpusat yang merekam setiap aktivitas pencarian plat kendaraan yang dilakukan melalui Lenz. Setiap kali seorang pengguna atau sistem menggunakan fitur Plate Search, rekaman permintaan tersebut — termasuk nomor plat yang dicari, pengguna yang melakukan pencarian, alamat IP asal, metode pencarian, dan status hasilnya — disimpan secara otomatis dan dapat ditelusuri di halaman ini.

Halaman ini ditujukan untuk admin dan auditor yang perlu memantau dan membuktikan siapa mengakses data pencarian kendaraan, kapan, dan dengan hasil apa.

Plate Search Logs hanya dapat diakses oleh pengguna dengan izin plate-searching-logs. Pastikan role Anda memiliki izin tersebut sebelum mengakses halaman ini. Hubungi administrator sistem jika Anda tidak dapat mengakses halaman ini.

Halaman ini terdiri dari dua tab:

TabFungsi
LogTabel audit trail seluruh aktivitas pencarian plat dengan filter dan export PDF
StatistikRingkasan agregat: total pencarian, tingkat keberhasilan, distribusi status, dan akses per pengguna

Cara Menggunakan

Menelusuri Log Pencarian Plat

Buka halaman Plate Search Logs

Akses /plate-search-logs dari sidebar. Halaman akan terbuka pada tab Log secara default. Secara bawaan, tabel menampilkan log pada hari ini dari pukul 00:00 hingga 23:59.

Atur rentang tanggal

Klik field Rentang Tanggal di area filter untuk memilih periode audit yang ingin Anda telusuri. Pilih tanggal mulai dan tanggal selesai, lalu konfirmasi pilihan Anda. Filter tanggal berlaku untuk kedua tab (Log dan Statistik) secara sinkron.

Terapkan filter tambahan (opsional)

Di area filter tersedia beberapa filter tambahan:

  • Alamat IP — Masukkan alamat IP untuk menelusuri aktivitas dari perangkat atau jaringan tertentu.
  • Status — Pilih Berhasil (200), Kesalahan Klien (400), atau Kesalahan Server (500) untuk memfilter berdasarkan hasil pencarian.
  • Sumber — Pilih Manual (pencarian yang dimulai oleh pengguna secara langsung) atau Otomatis (pencarian yang dipicu oleh sistem atau integrasi).

Klik Reset untuk menghapus semua filter dan kembali ke tampilan default.

Telusuri tabel hasil

Tabel menampilkan kolom berikut untuk setiap entri log:

  • Permintaan — Data plat yang dicari dalam permintaan tersebut
  • Waktu — Timestamp pencarian dengan presisi detik
  • Metode Pencarian — Endpoint atau metode yang digunakan (contoh: plate-search)
  • Status — Kode status HTTP hasil pencarian
  • Alamat IP — IP asal permintaan
  • Pengguna — Nama pengguna atau API key yang melakukan pencarian
  • Aksi — Tombol untuk melihat detail lengkap permintaan dan respons

Klik baris mana pun atau ikon Aksi untuk membuka dialog detail yang menampilkan data permintaan (request) dan data respons (response) secara lengkap.

Gunakan kontrol pagination di bawah tabel untuk berpindah antar halaman. Anda dapat mengatur jumlah data per halaman sesuai kebutuhan. Filter aktif dan nomor halaman saat ini disimpan secara otomatis di URL sehingga Anda dapat berbagi tautan atau kembali ke posisi yang sama.

Melihat Statistik Penggunaan

Beralih ke tab Statistik

Klik tab Statistik di bagian atas halaman. Filter tanggal yang sudah Anda atur di tab Log akan otomatis diterapkan di sini.

Baca ringkasan dan visualisasi

Bagian ringkasan menampilkan empat metrik utama: Total Pencarian, Berhasil (status 200), Gagal (status 400/500), dan Tingkat Keberhasilan (persentase). Di bawahnya terdapat Distribusi Status (grafik proporsi tiap kode HTTP) dan Akses Pengguna (peringkat pengguna paling aktif, diurutkan dari tertinggi).

Export Log ke PDF

Klik tombol Ekspor ke PDF di area filter pada tab Log. Tombol ini aktif hanya jika tabel menampilkan setidaknya satu entri. File PDF akan terunduh otomatis dengan nama seperti plate-search-logs-20240115-143022.pdf, berisi tabel log halaman saat ini dengan kolom: Permintaan, Waktu, Metode Pencarian, Alamat IP, dan Pengguna.

Export PDF hanya mencakup data pada halaman saat ini. Jika Anda memerlukan export seluruh data, navigasi ke setiap halaman dan lakukan export secara terpisah, atau hubungi administrator untuk export langsung dari database.

Fitur Utama

Audit Trail Lengkap

Setiap pencarian plat tercatat otomatis: siapa penggunanya, dari IP mana, kapan, metode apa yang digunakan, dan apa hasilnya — tidak ada yang terlewat.

Filter Multi-dimensi

Saring log berdasarkan kombinasi rentang tanggal, alamat IP, status HTTP, dan sumber pencarian (manual atau otomatis) untuk investigasi yang presisi.

Detail Permintaan dan Respons

Setiap entri log dapat dibuka untuk melihat data permintaan (request) dan respons mentah secara lengkap, termasuk timestamp dan metode pencarian.

Statistik Penggunaan

Tab Statistik menyajikan total pencarian, tingkat keberhasilan, distribusi status, dan peringkat pengguna aktif dalam periode tertentu.

Export ke PDF

Dokumentasikan log audit ke file PDF yang siap dilampirkan dalam laporan kepatuhan atau investigasi insiden.

Sinkronisasi URL dan Filter

Semua filter aktif dan nomor halaman disimpan di URL secara otomatis, sehingga Anda dapat berbagi tautan langsung ke hasil penelusuran tertentu.

API Reference

Dokumentasi lengkap endpoint tersedia di halaman terpisah agar lebih mudah dinavigasi.

API Reference — Plate Search Logs

Endpoint daftar log, statistik keberhasilan, dan statistik akses pengguna. Lengkap dengan contoh request dan response.

Semua endpoint memerlukan autentikasi. Sertakan header Authorization: Bearer <token> atau X-Api-Key: <key> pada setiap request. Lihat Otentikasi untuk detail.

GET /api/log-investigate — Daftar Log

Mengambil daftar entri log investigasi dengan pagination dan filter.

GET /api/log-investigate
Authorization: Bearer <token>

Contoh request:

GET /api/log-investigate?page=1&limit=10&filter[type]=plate&filter[status_code]=200&filter[source]=manual

Query Parameters:

Prop

Type

Contoh respons:

{
  "ok": true,
  "message": "successfully get log investigates",
  "result": {
    "limit": 10,
    "current_page": 1,
    "total_data": 85,
    "total_page": 9,
    "log_investigates": [
      {
        "id": 1042,
        "type": "plate",
        "method": "POST",
        "search_method": "plate-search",
        "ip_address": "192.168.1.55",
        "location": "",
        "path": "/api/v1/plate-search",
        "request": { "plate_number": "B1234XYZ" },
        "request_image": "",
        "response": { "result": { "plate_number": "B1234XYZ", "confidence": 0.97 } },
        "status_code": 200,
        "user_metadata": {
          "name": "Ahmad Fauzi",
          "user_id": 12,
          "auth_type": "token",
          "api_key_name": ""
        },
        "created_at": "2024-01-15T09:41:32Z"
      }
    ]
  }
}

Field respons:

Prop

Type

GET /api/log-investigate/statistics — Statistik Log

Mengambil statistik agregat keberhasilan dan kegagalan pencarian dalam periode tertentu.

GET /api/log-investigate/statistics
Authorization: Bearer <token>

Contoh request:

GET /api/log-investigate/statistics?filter[type]=plate&filter[timestamp_from]=2024-01-01T00:00:00Z&filter[timestamp_to]=2024-01-31T23:59:59Z

Query Parameters:

Prop

Type

Contoh respons:

{
  "ok": true,
  "message": "successfully get log investigate statistics",
  "result": {
    "total_success": 312,
    "total_failed": 18
  }
}

GET /api/log-investigate/user-access-statistics — Statistik Akses Pengguna

Mengambil jumlah akses pencarian plat yang dikelompokkan per pengguna, diurutkan dari yang paling aktif.

GET /api/log-investigate/user-access-statistics
Authorization: Bearer <token>

Contoh request:

GET /api/log-investigate/user-access-statistics?filter[type]=plate&filter[timestamp_from]=2024-01-01T00:00:00Z&filter[timestamp_to]=2024-01-31T23:59:59Z

Contoh respons:

{
  "ok": true,
  "message": "successfully get user access statistics",
  "result": [
    { "name": "Ahmad Fauzi", "total_access": 187 },
    { "name": "Siti Rahayu", "total_access": 94 },
    { "name": "super admin", "total_access": 31 }
  ]
}

Prop

Type

Tips dan Troubleshooting

Selanjutnya

Plate Search

Lakukan pencarian plat kendaraan secara langsung berdasarkan nomor plat atau gambar kendaraan.

Face Search Logs

Audit trail aktivitas pencarian wajah — siapa mencari siapa, kapan, dan dengan hasil apa.

Audit Logs

Log perubahan konfigurasi sistem: siapa mengubah apa kapan di seluruh entitas Lenz.

API Reference — Face Search Logs

Endpoint untuk mengambil log pencarian wajah, statistik keberhasilan, dan statistik akses pengguna.

API Reference — Plate Search Logs

Endpoint untuk mengambil audit trail pencarian plat kendaraan (LPR), statistik keberhasilan, dan statistik akses per pengguna.

On this page

PengenalanCara MenggunakanMenelusuri Log Pencarian PlatBuka halaman Plate Search LogsAtur rentang tanggalTerapkan filter tambahan (opsional)Telusuri tabel hasilNavigasi halamanMelihat Statistik PenggunaanBeralih ke tab StatistikBaca ringkasan dan visualisasiExport Log ke PDFFitur UtamaAPI ReferenceGET /api/log-investigate — Daftar LogGET /api/log-investigate/statistics — Statistik LogGET /api/log-investigate/user-access-statistics — Statistik Akses PenggunaTips dan TroubleshootingSelanjutnya