Sites
Kelola lokasi fisik dan area sebagai kelompok logis untuk stream — mendukung hierarki parent-child seperti gedung, lantai, dan ruangan.
Pengenalan
Bayangkan Sites seperti folder untuk kamera Anda — tetapi folder yang mencerminkan tata letak nyata gedung Anda. Sama seperti Anda menyusun dokumen ke dalam folder "Lantai 1 → Ruang Rapat A", Sites memungkinkan Anda menyusun kamera ke dalam struktur yang mencerminkan lokasi fisik mereka yang sesungguhnya. Supervisor yang bertugas di lantai tertentu dapat langsung membuka tampilan lantai tersebut dan melihat semua kamera yang relevan — tanpa perlu mencari satu per satu.
Sites adalah unit pengelompokan logis yang merepresentasikan lokasi atau area fisik di dunia nyata — mulai dari gedung, lantai, hingga ruangan tertentu. Dengan Sites, operator dapat mengorganisasi stream kamera berdasarkan lokasi sehingga pemantauan menjadi lebih terstruktur dan mudah dinavigasi.
Setiap Site dapat memiliki parent site, membentuk hierarki yang mencerminkan struktur fisik lokasi Anda. Sistem mendukung hingga tiga level kedalaman: top-level (misalnya gedung), child (misalnya lantai), dan grandchild (misalnya ruangan). Stream kemudian ditetapkan ke site spesifik — terutama ke node daun (leaf) pada hierarki — agar dapat ditampilkan dan difilter secara terkelompok.
Hierarki Sites bersifat fleksibel. Anda dapat membuat site datar tanpa parent, atau membangun pohon lokasi bertingkat sesuai kebutuhan organisasi Anda.
Bagi integrator, semua operasi Sites tersedia melalui REST API. Endpoint Sites mendukung Federation Mode untuk deployment multi-instance, pembaruan batch, penetapan stream, serta pengurutan stream per site. Site diidentifikasi secara unik oleh id (integer) yang bersifat permanen setelah site dibuat.
Mengapa Menggunakan Sites?
Berikut manfaat nyata yang dirasakan operator dan supervisor sehari-hari:
- Filter lebih cepat di halaman Streams. Daripada menggulir ratusan kamera, pilih site tertentu dan lihat hanya kamera yang relevan di area tersebut.
- Pemantauan berbasis lokasi. Buka
/streams/siteuntuk melihat semua kamera di suatu area sekaligus — termasuk kamera dari sub-area di bawahnya yang otomatis rolled up ke tampilan parent. - Serah terima shift yang lebih mudah. Supervisor yang baru masuk langsung tahu kamera mana yang termasuk dalam area tanggung jawabnya, tanpa perlu diberitahu satu per satu.
- Routing notifikasi yang lebih tepat. Alert dapat difilter berdasarkan site, sehingga insiden di Lantai 2 hanya diteruskan ke pengawas yang bertanggung jawab di lantai tersebut.
Rencanakan Hierarki Anda
Sebelum mulai membuat Sites, luangkan waktu sejenak untuk merencanakan struktur yang paling sesuai dengan kondisi nyata lokasi Anda. Berikut tiga pola yang umum digunakan:
Satu gedung kecil (1 level — flat).
Jika Anda hanya memiliki 5–10 kamera dalam satu gedung, hierarki bertingkat justru menambah kompleksitas tanpa manfaat nyata. Buat satu site per area fungsional secara langsung: Parkir, Lobby, Gudang.
Gedung perkantoran multi-lantai (2 level).
Struktur Gedung → Lantai sudah cukup untuk sebagian besar kantor. Misalnya: Gedung Utama → Lantai 1, Lantai 2, Lantai 3. Stream ditetapkan langsung ke site lantai.
Kampus atau properti majemuk (3 level).
Untuk kompleks dengan beberapa gedung, gunakan tiga level penuh: Properti → Gedung → Area. Misalnya: Kampus Selatan → Gedung R&D → Lab 01, Lab 02.
Sistem membatasi kedalaman hierarki hingga 3 level (top-level, child, grandchild). Anda tidak dapat membuat level keempat. Rencanakan hierarki Anda dari awal agar tidak perlu restrukturisasi besar-besaran kemudian.
Jika Anda merasa butuh level keempat, coba gunakan konvensi penamaan yang lebih deskriptif di level yang ada — misalnya "Lantai 02 — Sayap Utara" daripada membuat level baru untuk sayap.
Cara Menggunakan
Melihat Daftar Site
Buka halaman Sites untuk melihat seluruh hierarki lokasi Anda dalam sekali pandang.
Buka halaman Sites
Navigasikan ke /sites dari sidebar. Tampilan utama menampilkan seluruh site dalam bentuk Tree View yang mencerminkan hierarki parent-child. Gunakan tombol Expand Semua atau Sembunyikan Semua di toolbar untuk mengatur tampilan pohon.
Gunakan pencarian untuk menemukan site tertentu
Ketik nama site di kotak pencarian yang tersedia di bagian atas daftar. Hasil pencarian akan menyaring tree secara real-time sesuai nama yang diketik. Hasil yang cocok tetap ditampilkan bersama konteks parent-nya agar hierarki tetap terbaca.
Baca informasi site
Setiap baris site pada tree menampilkan: nama site, parent site (jika ada), instance asal (pada mode Federation), jumlah stream langsung dan rolled up, serta tombol aksi — Edit, Hapus, dan Tambah Child untuk membuat sub-site di bawahnya.
Menambah Site Baru
Gunakan ini untuk mendaftarkan area atau lokasi baru ke dalam sistem — misalnya saat membuat struktur awal sebelum kamera dipasang.
Klik tombol Tambah Situs
Tombol ini tersedia di toolbar kanan atas halaman /sites. Dialog form penambahan site akan muncul.
Isi informasi site
Lengkapi field berikut pada form:
- Nama Site — nama deskriptif untuk site (wajib, minimal 2 karakter). Contoh:
Gedung A,Lantai 3,Ruang Server. Jika nama sudah digunakan di level yang sama, sistem akan menampilkan pesan validasi. - Parent Site (Opsional) — pilih site yang akan menjadi induk. Biarkan kosong untuk membuat top-level site. Dropdown ini memiliki kotak pencarian — ketik sebagian nama untuk menyaring pilihan.
- Instance — (tersedia di Federation Mode) pilih instance tempat site akan dibuat. Instance tidak dapat diubah setelah site disimpan.
Klik Buat Site
Sistem akan menyimpan site baru. Site akan langsung muncul di tree view pada posisi yang sesuai dengan hierarki parent yang dipilih.
Nama site harus unik di dalam level yang sama. Dua site dengan nama yang sama diperbolehkan selama memiliki parent yang berbeda — misalnya dua site bernama "Lantai 1" di bawah gedung yang berbeda.
Mengedit Site
Gunakan ini untuk mengganti nama site atau memindahkannya ke posisi lain dalam hierarki. Memindahkan site tidak akan memutuskan stream yang sudah terhubung.
Temukan site yang ingin diedit
Di tree view, cari site menggunakan kotak pencarian atau navigasi manual pada pohon hierarki.
Klik ikon Edit pada baris site
Dialog edit akan muncul dengan data site saat ini yang sudah terisi.
Ubah informasi yang diperlukan
- Nama Site — perbarui nama site.
- Parent Site — pindahkan site ke parent yang berbeda untuk mengubah posisinya dalam hierarki. Pilih kosong untuk menjadikannya top-level site.
Instance tidak dapat diubah setelah site dibuat.
Klik Perbarui Site
Perubahan akan diterapkan dan tree view akan diperbarui secara otomatis.
Memindahkan site ke parent yang berbeda tidak memengaruhi stream yang sudah ditetapkan ke site tersebut. Stream tetap terhubung ke site yang sama meskipun posisi site dalam hierarki berubah. Anda tidak akan kehilangan data assignment hanya karena mengganti nama atau memindahkan posisi site.
Menambah Child Site
Gunakan ini saat memperluas deployment — misalnya setelah sayap baru gedung selesai dibangun dan kamera baru akan dipasang di sana.
Untuk membuat sub-site langsung di bawah site tertentu, klik tombol Tambah Child pada baris site yang diinginkan di tree view. Form yang muncul akan otomatis menetapkan site tersebut sebagai parent — Anda hanya perlu mengisi nama child site yang baru.
Menghapus Site
Dampak penghapusan yang perlu dipahami: Saat sebuah site dihapus, child langsung (satu level di bawahnya) akan dipindahkan ke level root — bukan ikut terhapus. Grandchild dan seterusnya ikut naik bersama child yang dipindahkan tersebut. Stream yang ditetapkan ke site yang dihapus akan dilepaskan dari site tersebut (assignment dihapus).
Sebagai ilustrasi, jika Anda menghapus site Lantai 1 dari struktur di bawah ini:
Hasilnya setelah penghapusan:
Lobby Depan dan Ruang Resepsi kini menjadi top-level site, tidak lagi di bawah Gedung Utama.
Klik ikon Hapus pada baris site
Dialog konfirmasi akan muncul, menampilkan ringkasan dampak penghapusan: daftar child site yang akan dipromosikan ke root dan jumlah stream aktif yang akan dilepaskan.
Baca peringatan dengan seksama
Pastikan Anda memahami seluruh dampak sebelum melanjutkan, terutama jika site memiliki child site dan stream aktif.
Klik Hapus Site untuk mengonfirmasi
Penghapusan bersifat permanen dan tidak dapat dibatalkan.
Hierarki Site
Sites mendukung struktur pohon (tree) yang merepresentasikan lokasi fisik secara bertingkat. Berikut contoh struktur hierarki tipikal untuk sebuah kompleks perkantoran:
Pada struktur di atas:
- Gedung Utama dan Gedung Annex adalah top-level site (tanpa parent).
- Lantai 1, Lantai 2, Lantai 3 adalah child site di bawah Gedung Utama.
- Lobby Depan, Ruang Rapat A, dst. adalah grandchild site (level terdalam).
- Stream kamera biasanya ditetapkan ke grandchild site — lokasi paling spesifik.
Stream Rolled Up per Site
Saat operator membuka tampilan /streams/site dan memilih sebuah site, semua stream dari sub-site di bawahnya ditampilkan secara otomatis — tidak hanya stream yang langsung ditetapkan ke site tersebut.
Contoh: Gedung dengan dua lantai, kamera hanya ditetapkan ke site ruangan (level grandchild):
Ketika operator membuka Lantai 1 di /streams/site, mereka melihat 3 kamera (Lobby + Resepsi) meskipun tidak ada kamera yang ditetapkan langsung ke site "Lantai 1". Ketika membuka Gedung Utama, mereka melihat 6 kamera dari semua ruangan di bawahnya.
Ini memungkinkan supervisor memantau seluruh area tanggung jawabnya dengan membuka satu site, tanpa perlu membuka setiap ruangan satu per satu.
Operasi Batch dan Pengurutan
Pembaruan Batch
Berguna saat Anda perlu melakukan reorganisasi skala besar — misalnya setelah gedung berganti nama atau struktur organisasi berubah dan Anda perlu memindahkan puluhan site ke parent yang berbeda sekaligus.
Melalui endpoint PATCH /api/sites/batch, Anda dapat memperbarui nama, parent, dan urutan beberapa site dalam satu request. Di UI, urutan hierarki juga dapat diubah melalui drag-and-drop pada tree view — perubahan posisi otomatis disimpan ke server setelah drag selesai.
Pengurutan Stream dalam Site
Berguna saat operator ingin kamera yang paling sering diawasi muncul di bagian atas grid monitoring. Atur urutan tampilan stream dalam setiap site melalui tampilan Atur Urutan di panel stream, atau langsung via endpoint PUT /api/sites/:id/streams/order.
Federation Mode
Jika organisasi Anda menjalankan Lenz di beberapa lokasi atau data center yang terpisah, setiap lokasi menjalankan instance-nya sendiri dengan Sites masing-masing. Federation Mode memungkinkan Anda melihat Sites dari seluruh instance dalam satu tampilan terpadu.
Pada mode Federation:
- Setiap site memiliki field
instanceyang menunjukkan dari instance mana site tersebut berasal. - Endpoint
GET /api/sitesmenerima parameteris_aggregated=trueuntuk mengambil site dari seluruh instance sekaligus, atauinstance=<id>untuk membatasi ke instance tertentu. - Instance pada site bersifat permanen setelah site dibuat — tidak dapat dipindahkan antar instance.
Fitur Utama
Tree View Hierarki
Tampilan pohon interaktif yang mencerminkan struktur fisik lokasi Anda. Expand dan collapse node untuk navigasi yang efisien, bahkan pada deployment dengan ratusan site.
Parent-Child Site
Bangun hierarki lokasi bertingkat (gedung → lantai → ruangan) untuk mengorganisasi stream secara terstruktur sesuai layout fisik.
Pembaruan Batch
Perbarui nama, parent, dan urutan beberapa site sekaligus melalui endpoint PATCH /api/sites/batch — ideal untuk reorganisasi skala besar.
Pengurutan Stream
Atur urutan tampilan stream dalam setiap site via drag-and-drop di UI atau endpoint PUT /api/sites/:id/streams/order untuk kontrol lebih presisi.
Stream Rolled Up
Stream yang ditetapkan ke child site otomatis ditampilkan pada parent site — operator dapat memantau seluruh area hanya dengan membuka site level atas.
Federation Support
Dalam deployment multi-instance, site dari seluruh instance dapat dikelola dan ditampilkan secara agregat melalui parameter instance dan is_aggregated.
Tips & Troubleshooting
Selanjutnya
Statistics: LPR (License Plate Recognition)
Pantau performa pengenalan plat nomor kendaraan — total deteksi, distribusi per Stream, analisis waktu puncak, dan tren — langsung dari Lenz Dashboard.
API Reference — Sites
Endpoint untuk mengelola Site (lokasi fisik), hierarki parent-child, penetapan stream, dan pembaruan batch.