Best Practices & Troubleshooting
Praktik terbaik, keterbatasan sistem, dan runbook untuk pesan yang muncul di log/side message Crowd Estimation.
Best Practices
Penempatan Kamera
Gunakan sudut elevated overview, bukan bird's-eye langsung ke bawah — model deteksi orang pelengkap mengasumsikan siluet tubuh masih terlihat. Lihat Persyaratan — Penempatan Kamera untuk detailnya.
Definisi ROI
- Batasi
areaspada zona yang benar-benar ingin dipantau — ROI yang jauh lebih kecil dari FOV kamera membuang resolusi efektif per orang setelah frame di-resize. - Beri
nameyang deskriptif ("Pintu Masuk Utara","Area Panggung") karena nilai ini yang muncul padapipeline_data.areadi setiap event. - Selalu kirim ulang seluruh array
areassetiap kali melakukanPUT, meskipun Anda hanya ingin mengubahinterval. Konfigurasi tidak digabung (merge) secara parsial — jikaareastidak disertakan pada bodyPUT, pipeline kembali memakai ROI default tunggal yang mencakup seluruh frame.
Tuning Interval
- Default
interval: 10cocok untuk monitoring real-time. - Naikkan ke
30–60untuk skenario analitik historis yang tidak memerlukan respons cepat — ini juga mengurangi volume event. - Turunkan ke
5jika Anda memerlukan respons lebih cepat untuk alert overcrowding.
Memahami Mode Pelengkap Kepadatan Rendah
Pipeline otomatis menyalakan model deteksi orang tambahan saat estimasi seluruh frame di bawah ±10 orang, dan mematikannya di atas ±500 orang. Ambang ini dihitung dari total frame, bukan per-ROI — jadi pada pipeline dengan beberapa ROI, penyalaan/pematian model pelengkap dipengaruhi kepadatan gabungan seluruh area, bukan kepadatan salah satu ROI saja. Perilaku ini tidak dapat dikonfigurasi.
Alerting
NFV4-CE tidak memiliki threshold alert bawaan. Implementasikan logika kapasitas di sisi aplikasi Anda, misalnya membandingkan pipeline_data.estimation terhadap batas kapasitas venue setiap event masuk.
Keterbatasan
- Tidak ada
tracker_id/ identitas individu — NFV4-CE hanya menghasilkan angka estimasi agregat per ROI. Gunakan People Analytics untuk data per-individu. - Estimasi statistik, bukan hitungan exact — nilai
estimationberasal dari jumlah titik yang jatuh dalam ROI selama satu interval, dirata-rata; ini adalah pendekatan, bukan sensus presisi. - Tidak ada parameter ukuran minimum objek — berbeda dari Face Recognition (
fr_min_face_size), tidak ada filter ukuran yang bisa Anda tuning untuk menolak titik/objek yang terlalu kecil akibat FOV yang terlalu lebar. roi_typediterima tetapi tidak berpengaruh — mengirim"roi_type": "blacklist"tidak membuat area tersebut dikecualikan dari penghitungan; kode filter titik pada Crowd Estimation selalu menghitung titik yang berada di dalam polygon, apa pun nilairoi_type-nya.- Ambang mode pelengkap bersifat tetap — batas 10/500/2 pada mekanisme kepadatan rendah adalah nilai internal (hardcoded), tidak dapat diubah lewat parameter API atau environment variable.
- Frame rate pipeline tetap 1 FPS — tidak ada parameter untuk menaikkan sampling rate; ini cukup untuk estimasi kepadatan tetapi tidak untuk analitik gerakan cepat.
- Konfigurasi
areastidak di-merge parsial — lihat catatan "Definisi ROI" di atas. - Tidak ada preset, environment variable, atau argumen CLI khusus — seluruh tuning hanya lewat
areas,interval, danconfidencepada body request.
Troubleshooting
Gunakan docker logs <container_visionaire4> untuk melihat log lengkap. Sebagian pesan berikut adalah side message pipeline (terlihat di status pipeline/live view), sebagian lain hanya muncul di container log.