Dashboards

Dashboard adalah halaman berisi widget yang menampilkan data dari channel Anda. Menu: Dashboards.

Daftar dashboard

Tampilan kartu atau tabel, pencarian (nama, tag, ID), urutan, dan filter jenis (Dashboard atau Template). Aksi pada tiap dashboard: ubah metadata, bagikan, duplikat (atau buat dari template), salin ID, dan hapus. Tersedia Buat dashboard dan Upload (JSON).

Membuat dashboard

Pilih Buat dashboard, isi nama, deskripsi, tag, dan jenis (Dashboard atau Template). Gambar mini (JPEG 640×360 otomatis dari gambar maksimal 5 MB) bisa dipasang lewat Ubah metadata. Dashboard baru selalu privat.

Halaman dashboard

Toolbar mode lihat: Mode edit, Bagikan, Muat ulang, Layar penuh, Unduh JSON, Ekspor PDF, dan Mode buta warna (penanda bentuk dan gaya garis berbeda per seri, disimpan per browser).

Mode edit

1. Pilih Mode edit.
2. Tambah widget, pilih jenisnya, lalu isi konfigurasi.
3. Seret widget lewat judulnya untuk memindah, dan seret pojok untuk mengubah ukuran. Perubahan tersimpan otomatis.
4. Pilih Layout (misalnya Desktop (12)) untuk menyusun tata letak terpisah per ukuran layar: lg (desktop, 12 kolom), md (laptop, 10), sm (tablet, 6), xs (ponsel, 4), xxs (ponsel kecil, 2). Breakpoint ditentukan oleh lebar kontainer, bukan lebar layar.
5. Menu pada widget: ikon muat ulang, ikon pensil (ubah), dan menu titik tiga (duplikat, hapus). Ubah dashboard mengedit nama, deskripsi, tag, dan gambar mini; Mode lihat kembali ke tampilan biasa.

Mode edit.

Dialog Tambah widget.

Server membatasi dokumen: maksimal 50 widget, 10 sumber per widget, dan konfigurasi widget maksimal 16 KiB. Dua orang yang menyunting bersamaan dilindungi oleh penguncian versi: bila versi usang, muncul spanduk Muat ulang.

Widget

Kategori	Widget
Deret waktu	Line Chart, Area Chart, Bar Chart, Pie Chart
Kartu	Value Card (satu angka dengan ambang warna), Count Card (jumlah device, gateway, channel, rule, dashboard, atau alarm), Table Card
Gauge	Gauge Chart (rentang dan zona warna)
Status	Status ON/OFF untuk sensor boolean (pintu, kontak) beserta sejak kapan dan jumlah perubahan
Kontrol	Switch, Slider (mengirim pesan ke channel)
Peta	Peta (penanda device dan perimeter dari metadata), Route Map (jalur GPS)
Alarm	Alarm Table
Fasilitas	Building Overview (status baca device per gedung dan lantai)

Konfigurasi umum

• Sumber data (bisa beberapa): Channel, Device (opsional; memfilter publisher), Nama nilai (misalnya temp_inlet atau 001a2b3c4d5e:temp_inlet, dengan autocomplete), serta Label dan Warna.
• Jendela waktu: Realtime (N detik terakhir, dari 1 detik sampai 30 hari, dengan interval pembaruan) atau History (dari dan sampai).
• Agregasi: none, min, max, avg, sum, count, atau last, dengan interval dan jumlah titik.
• Tampilan: satuan, desimal, label sumbu, tebal garis, ambang warna (Value Card), zona (Gauge), dan data contoh untuk pratinjau.
• Pemilih channel dan device menampilkan 100 teratas menurut nama.

Banyak device di channel yang sama

Bila beberapa device memakai nama metrik yang sama di satu channel (misalnya semuanya temp_inlet), pilih Device pada sumber, kalau tidak nilainya akan bercampur. Untuk sensor di belakang gateway, pakai nama berawalan <bn>:.

Widget khusus

Switch dan Slider mengirim pesan ke channel atas nama Anda (izin channel.publish), dinonaktifkan di mode edit. Slider mengirim saat dilepas. Pilih format SenML ([{"n": nama, "v": 1|0|nilai}]) atau JSON (payload ON/OFF atau template dengan {{value}}), channel, subtopik, dan bentuk topik (route atau UUID). Penting: broker mencocokkan topik secara literal, jadi device harus berlangganan bentuk topik yang sama dengan yang dipilih widget.

Peta membaca metadata location dan perimeter pada device (Metadata) dan menunjukkan status koneksi dengan ikon dan teks, bukan warna saja.

Route Map menggambar jalur pelacak GPS dari data tersimpan. Panduan lengkap: Pelacak GPS dan Route Map.

Building Overview mengelompokkan device per gedung dan lantai (dari metadata building dan floor): hijau = sudah mengirim data dalam rentang yang ditentukan, merah = belum, biru = gateway. Setiap penanda juga membawa ikon, dan mengarah ke detail device.

Alarm Table menampilkan alarm menurut status dan severity.

Berbagi

Pilih Bagikan (butuh izin dashboard.share):

Opsi	Arti
Privat	Hanya pembuat dan pemegang izin share.
Anggota workspace	Semua anggota dengan izin dashboard.read.
Pengguna tertentu	Sampai 50 anggota yang Anda pilih.
Publik	Siapa pun yang punya tautan /share/d/<token>, tanpa login.

Dialog Bagikan.

Data widget dibaca dengan izin orang yang melihat dashboard, bukan izin pembuatnya, jadi berbagi dashboard tidak membuka data channel yang tidak boleh dilihat penerima.

Tautan publik

• Tokennya acak 256 bit. Buat tautan baru memutar token (tautan lama langsung 404). Beralih ke opsi lain mencabut token.
• Hanya baca. Widget Switch, Slider, dan Count Card tidak tersedia di tampilan publik. Peta, Route Map, Building Overview, dan Status juga tidak tersedia karena memuat lokasi atau keadaan device.
• Data hanya bisa dibaca lewat konfigurasi widget yang tersimpan, jadi token tidak bisa dipakai membaca channel atau metrik lain.
• Pemberi akses publik harus sendiri boleh membaca semua channel yang dipakai widget.
• Batas 300 permintaan per menit per token. Halaman tidak diindeks mesin pencari dan tidak membawa referrer.
• Template tidak bisa dibuat publik.

Ekspor dan impor

• Ekspor PDF: membuka tampilan cetak (halaman A4 lanskap, tema terang, widget tidak terbelah di antara halaman) lalu dialog cetak browser; pilih Simpan sebagai PDF.
• Unduh JSON dan Upload JSON: format {name, description, tags, type, layouts, widgets}. Berguna untuk memindahkan dashboard antar-workspace atau memulai dari template.
• Template: dashboard bertipe Template bisa disalin menjadi dashboard biasa (salinan selalu privat dan milik Anda, tanpa gambar mini).

Izin

dashboard.read, dashboard.write, dashboard.delete, dan dashboard.share, termasuk per objek dan per tag. Dashboard yang tidak boleh Anda lihat menjawab 404.