Menghubungkan Grafana
Panduan ini menunjukkan cara menghubungkan Grafana ke DataHub untuk memvisualisasikan data telematika dan armada. Grafana menyediakan kemampuan visualisasi yang kuat untuk memantau status kendaraan, data sensor, dan metrik lainnya secara real-time.
Tonton video ringkas untuk melihat apa yang mungkin dilakukan dengan kombinasi DataHub+Grafana (tersedia dalam bahasa Inggris dan Spanyol):
Fitur dashboard
Visualisasi data sensor real-time
Analisis deret waktu dengan rentang waktu yang dapat disesuaikan
Penyaringan dinamis menggunakan variabel
Dukungan untuk beberapa sumber data
Grafik dan bagan interaktif
Pembuatan kueri khusus dengan SQL
Persyaratan teknis
Grafana 9.3 atau lebih baru
plugin sumber data PostgreSQL (termasuk secara default)
Akses internet untuk koneksi basis data
Instansi DataHub aktif dengan kredensial koneksi
Instalasi dan penyiapan
Grafana harus diinstal pada sistem Anda sebelum dapat menghubungkan ke DataHub.
Instal Grafana
Unduh dan instal Grafana dari situs web resmi: https://grafana.com/grafana/download
Ikuti petunjuk instalasi untuk sistem operasi Anda.
Unduh template dashboard (opsional)
Template dashboard yang sudah dibuat tersedia untuk membantu Anda memulai dengan cepat tanpa membangun visualisasi dari awal. Template ini dipelihara di bi-intergrations repository di bawah grafana folder. Anda dapat meng-klone repository untuk mengakses dashboard siap pakai:
Periksa grafana folder untuk file JSON dashboard yang tersedia.
Koneksi basis data
Bagian Connections di Grafana adalah tempat Anda mengelola semua integrasi sumber data. DataHub berjalan di PostgreSQL, jadi Anda perlu menambahkan sumber data PostgreSQL untuk memungkinkan Grafana melakukan kueri terhadap data telematika Anda.
Tambahkan sumber data PostgreSQL
Plugin sumber data PostgreSQL sudah terpasang bersama Grafana dan menyediakan dukungan native untuk menghubungkan ke database PostgreSQL.
Untuk menambahkan sumber data:
Di bagian Connections, cari PostgreSQL
Klik Add new data source
Halaman konfigurasi PostgreSQL akan terbuka
Konfigurasikan parameter koneksi
Detail koneksi DataHub Anda berisi semua informasi yang diperlukan untuk membangun koneksi yang aman. Parameter ini unik untuk instansi Anda dan memastikan Grafana dapat mengakses data telematika Anda.
Temukan parameter koneksi Anda di akun Navixy Anda dan email sambutan DataHub.
Referensi parameter koneksi
Host
Host
Alamat server basis data yang diberikan dalam detail koneksi DataHub Anda
Port
Port
Default adalah 5432 untuk PostgreSQL
Nama database
Database
Nama database yang ditugaskan kepada Anda
Nama pengguna
User
Nama pengguna database Anda (disebut sebagai "database user" dalam detail koneksi)
Kata sandi
Kata sandi
Kata sandi database Anda yang aman
Mode SSL
SSL Mode
Atur ke require untuk koneksi yang aman
Versi PostgreSQL
Version
Pilih 9.3 (pengaturan yang disarankan)
Konfigurasikan pengaturan tambahan
Selain parameter koneksi penting, Grafana menawarkan opsi konfigurasi tambahan. Untuk kebanyakan pengguna, nilai default sudah sesuai dan akan bekerja tanpa modifikasi. Anda dapat menyesuaikan pengaturan ini nanti berdasarkan kebutuhan keamanan organisasi, kendala infrastruktur, atau kebutuhan peralatan tertentu.
Biarkan semua bidang lain pada nilai default untuk penyiapan awal. Anda tidak perlu mengaktifkan sakelar atau toggle tambahan.
Uji koneksi
Menguji koneksi sebelum menyimpan memastikan semua parameter benar dan Grafana dapat berkomunikasi dengan instansi DataHub Anda.
Untuk memverifikasi dan menyimpan:
Beri nama koneksi Anda dengan pengidentifikasi deskriptif (misalnya, "DataHub Production" atau "Fleet Analytics")
Klik Save & Test untuk memverifikasi koneksi Anda
Pesan sukses berwarna hijau menunjukkan koneksi berfungsi dengan benar
Membuat visualisasi pertama Anda
Membangun visualisasi pertama membantu Anda memahami bagaimana Grafana melakukan kueri ke DataHub dan menampilkan data telematika. Proses ini melibatkan membuat dashboard, menambahkan panel, mengonfigurasi kueri, dan memilih format visualisasi yang sesuai.
Buat dashboard baru
Dashboard di Grafana berfungsi sebagai wadah untuk beberapa visualisasi. Membuat dashboard khusus membantu Anda mengatur visualisasi terkait dan menyediakan lokasi pusat untuk memantau aspek tertentu operasi armada Anda.
Untuk membuat dashboard:
Navigasikan ke Dashboards di bilah sisi kiri
Klik Create Dashboard
Pilih Tambahkan visualisasi
Pilih sumber data PostgreSQL yang baru saja Anda konfigurasi
Konfigurasikan kueri
Grafana menyediakan dua mode kueri: Builder visual dan editor Kode. Untuk koneksi DataHub, editor Kode memberi Anda kontrol penuh atas kueri SQL dan disarankan untuk analisis data telematika.
Untuk menulis kueri Anda:
Di editor kueri, alihkan dari Builder ke Code mode
Masukkan kueri SQL Anda secara langsung
Contoh kueri untuk visualisasi data sensor:
Kueri menyertakan komponen waktu (device_time AS time) yang penting untuk visualisasi deret waktu. Fungsi $__timeFilter() adalah makro Grafana yang secara otomatis menerapkan rentang waktu yang dipilih pada dashboard ke kueri Anda.
Untuk contoh kueri lainnya, rujuk ke SQL Recipe Book.
Atur format visualisasi
Format visualisasi menentukan bagaimana data Anda muncul di dashboard. Format yang berbeda cocok untuk jenis data yang berbeda—deret waktu cocok untuk pembacaan sensor dari waktu ke waktu, sementara tabel lebih baik untuk catatan terperinci.
Untuk mengonfigurasi format:
Klik Jalankan kueri untuk memverifikasi kueri Anda mengembalikan data
Temukan pemilih tipe visualisasi (biasanya di kanan atas panel)
Ubah format dari Table ke Time series atau format pilihan Anda
Amati tampilan data untuk memastikan tampil dengan benar
Visualisasi deret waktu memerlukan kolom waktu dan nilai numerik agar berfungsi dengan baik. Kueri Anda harus mengembalikan data dalam format yang sesuai untuk tipe visualisasi yang dipilih.
Simpan visualisasi Anda
Menyimpan pekerjaan Anda mempertahankan konfigurasi visualisasi dan membuatnya tersedia untuk referensi di masa mendatang. Menyimpan secara berkala penting—Grafana tidak menyimpan perubahan secara otomatis, jadi Anda bisa kehilangan pekerjaan jika berpindah tanpa menyimpan.
Untuk menyimpan visualisasi:
Klik Save
Berikan nama deskriptif untuk dashboard Anda
Pilih atau buat folder untuk pengorganisasian
Konfirmasi operasi penyimpanan
Dashboard sekarang tersedia di instansi Grafana Anda dan dapat diakses melalui menu Dashboards.
Bekerja dengan variabel
Variabel adalah salah satu fitur paling kuat di Grafana untuk membuat dashboard yang dinamis dan interaktif. Alih-alih menuliskan nilai tertentu seperti nama sensor atau ID perangkat dalam kueri Anda, variabel memungkinkan pengguna memilih nilai berbeda dari menu dropdown tanpa mengedit SQL di bawahnya. Ini membuat dashboard lebih fleksibel dan lebih mudah digunakan.
Akses pengaturan variabel
Variabel dikonfigurasi pada tingkat dashboard dan berlaku untuk semua visualisasi dalam dashboard tersebut. Anda perlu mengakses pengaturan dashboard untuk membuat dan mengelola variabel.
Untuk memulai:
Buka dashboard Anda
Klik Settings ikon (ikon roda gigi) di sudut kanan atas
Navigasikan ke Variables bagian di panel kiri
Bagian ini akan kosong jika belum ada variabel yang dibuat
Konfigurasikan sebuah variabel
Setiap variabel membutuhkan nama, sumber data, dan kueri yang mengembalikan nilai-nilai yang dapat dipilih pengguna. Nilai variabel diisi secara dinamis dengan melakukan kueri ke instansi DataHub Anda.
Untuk membuat variabel:
Klik Add variable
Konfigurasikan pengaturan berikut:
Pengaturan umum:
Name:
sensor_name(gunakan pengidentifikasi yang jelas dan deskriptif tanpa spasi)Label: Sama dengan name untuk konsistensi, ini yang dilihat pengguna di dashboard
Type: Pilih Query untuk mengisi nilai dari database
Opsi kueri:
Data source: Pilih koneksi PostgreSQL DataHub Anda dari dropdown
Query: Masukkan kueri SQL untuk mengisi nilai variabel
Contoh kueri untuk menampilkan semua sensor untuk perangkat tertentu:
Setelah memasukkan kueri, Grafana mengeksekusinya segera dan menampilkan pratinjau nilai yang dikembalikan di bagian bawah halaman konfigurasi. Ini mengonfirmasi kueri Anda bekerja dengan benar dan menunjukkan opsi apa yang akan tersedia di dropdown.
Terapkan variabel dalam kueri
Setelah variabel dibuat, Anda perlu memperbarui kueri visualisasi Anda untuk merujuknya. Variabel menggunakan sintaks khusus dengan awalan tanda dolar, dan Grafana secara otomatis menggantikan nilai yang dipilih saat mengeksekusi kueri.
Untuk menggunakan variabel:
Buka visualisasi yang ingin Anda buat dinamis
Edit kueri
Ganti nilai yang ditulis langsung dengan referensi variabel
Contoh kueri yang diperbarui menggunakan variabel:
Perhatikan bagaimana 'temperature' telah digantikan dengan '$sensor_name'. Tanda kutip penting untuk nilai string dalam SQL.
Simpan dan uji
Menguji variabel memastikan variabel bekerja dengan benar dan memperbarui visualisasi seperti yang diharapkan. Pastikan menyimpan pekerjaan Anda di setiap langkah untuk menghindari kehilangan perubahan konfigurasi.
Untuk menyelesaikan penyiapan:
Klik Apply untuk menyimpan konfigurasi variabel
Klik Save dashboard untuk mempertahankan semua perubahan
Kembali ke tampilan dashboard utama
Temukan dropdown variabel di bagian atas dashboard
Pilih nama sensor yang berbeda dari dropdown
Amati bahwa visualisasi memperbarui secara otomatis dengan data untuk sensor yang dipilih
Jika visualisasi tidak memperbarui saat Anda mengubah pilihan variabel, periksa bahwa nama variabel dalam kueri Anda persis sama dengan nama variabel yang Anda buat (nama variabel peka terhadap huruf besar/kecil).
Mengimpor dashboard yang sudah dibuat
Dashboard yang sudah dibuat menyediakan cara cepat untuk mulai memvisualisasikan data Anda tanpa membangun semuanya dari awal. Dashboard ini dirancang oleh pengguna berpengalaman dan mencakup praktik terbaik untuk visualisasi, tata letak, dan optimasi kueri. Namun, mereka memerlukan konfigurasi untuk terhubung ke instansi DataHub spesifik Anda.
Impor dashboard
Proses impor menerima konfigurasi dashboard dalam beberapa format, memberi Anda fleksibilitas dalam cara memuat dashboard yang sudah dibuat.
Anda dapat mengimpor dashboard menggunakan:
Dashboard ID dari Grafana.com
File JSON diunduh dari repository bi-intergrations
Model JSON yang ditempelkan langsung
Jika menggunakan file JSON:
Klik Unggah file JSON
Pilih file dashboard
Berikan nama dan pilih folder tujuan
Klik Import
Tunggu template dashboard selesai diunggah. Setelah selesai, dashboard akan muncul, tetapi belum akan menampilkan data karena masih terhubung ke sumber data asli yang digunakan saat template dibuat.
Perbarui koneksi sumber data
Ini adalah langkah krusial. Dashboard yang diimpor awalnya terhubung ke sumber data eksternal yang tidak memiliki akses ke data DataHub Anda. Anda harus memperbarui setiap visualisasi untuk menggunakan koneksi PostgreSQL DataHub Anda.
Untuk memperbarui visualisasi:
Buka dashboard yang diimpor
Klik Edit pada panel visualisasi pertama (cari ikon edit atau menu tiga titik)
Di editor kueri, temukan pemilih sumber data
Ubah sumber data dari sumber asli template ke koneksi PostgreSQL DataHub Anda
Klik Jalankan kueri untuk memverifikasi visualisasi mengambil data dengan sukses
Klik Save untuk menyimpan perubahan
Ulangi proses ini untuk setiap panel visualisasi di dashboard
Perbarui variabel dashboard
Banyak dashboard yang sudah dibuat menggunakan variabel untuk pemfilteran dan interaktivitas. Variabel ini juga terhubung ke sumber data asli dan harus diperbarui untuk melakukan kueri ke instansi DataHub Anda.
Untuk memperbarui variabel:
Buka Settings → Variables
Anda akan melihat daftar semua variabel yang digunakan dalam dashboard
Klik Edit pada variabel pertama
Temukan Data source dropdown di bagian Opsi Query
Ubah menjadi koneksi PostgreSQL DataHub Anda
Verifikasi bahwa pratinjau di bagian bawah menunjukkan nilai yang diharapkan dari basis data Anda
Klik Apply untuk mengonfirmasi perubahan
Ulangi untuk setiap variabel dalam daftar
Setelah memperbarui semua variabel, simpan dashboard lagi. Variabel sekarang seharusnya terisi dengan nilai dari instansi DataHub Anda.
Verifikasi fungsionalitas dashboard
Setelah Anda memperbarui semua visualisasi dan variabel, verifikasi bahwa semuanya bekerja bersama dengan benar. Pemeriksaan akhir ini memastikan dashboard berfungsi penuh dan siap digunakan secara rutin.
Untuk memverifikasi:
Simpan dashboard untuk terakhir kalinya menggunakan Ctrl+S atau Save tombol
Segarkan halaman browser sepenuhnya (atau gunakan F5)
Periksa bahwa semua visualisasi menampilkan data dengan benar
Uji setiap dropdown variabel untuk memastikan terisi dengan nilai
Pilih nilai variabel yang berbeda dan konfirmasi visualisasi memperbarui sesuai
Coba rentang waktu yang berbeda menggunakan pemilih waktu
Jika ada visualisasi yang tetap kosong atau menampilkan kesalahan, kembali ke mode edit dan periksa konfigurasi sumber data serta kueri untuk panel-panel tersebut.
Pemecahan masalah
Masalah koneksi basis data
Kesalahan koneksi: Verifikasi kredensial dan parameter koneksi sesuai persis dengan detail DataHub Anda. Periksa bahwa host, port, nama database, nama pengguna, dan kata sandi benar.
Kesalahan firewall: Pastikan jaringan Anda mengizinkan koneksi ke host dan port yang ditentukan. Hubungi administrator jaringan jika upaya koneksi diblokir.
Kesalahan SSL/TLS: Verifikasi mode SSL diset ke require dan instansi Grafana Anda mendukung koneksi SSL.
Masalah kueri dan visualisasi
Visualisasi kosong: Pertama, verifikasi bahwa kueri benar-benar mengembalikan data dengan memeriksa query inspector (klik tombol "Query inspector" di editor panel). Pastikan rentang waktu yang dipilih mencakup periode ketika data ada di basis data Anda. Konfirmasi sumber data dipilih dan terhubung dengan benar. Periksa bahwa nama tabel dan kolom dalam kueri cocok dengan struktur skema sebenarnya.
Variabel tidak berfungsi: Verifikasi bahwa kueri variabel mengembalikan nilai dengan memeriksa pratinjau di halaman konfigurasi variabel. Pastikan referensi variabel dalam kueri menggunakan sintaks yang benar ($variable_name) tanpa kesalahan ketik. Periksa bahwa variabel tersimpan dengan benar dan diterapkan ke dashboard. Jika dropdown variabel kosong, tinjau kueri SQL variabel untuk menemukan kesalahan.
Kinerja kueri lambat: Pertimbangkan menambahkan indeks basis data ke kolom yang sering di-kueri seperti device_time dan device_id. Batasi rentang data dengan menggunakan filter waktu secara lebih ketat. Optimalkan struktur kueri dengan memilih hanya kolom yang diperlukan daripada menggunakan SELECT *. Rujuk ke SQL Recipe Book untuk contoh optimasi kinerja dan pola kueri yang terbukti.
Ketidaksesuaian format: Pastikan kueri Anda mengembalikan data dalam format yang diharapkan oleh tipe visualisasi Anda. Panel deret waktu memerlukan kolom yang dialiaskan sebagai time dan kolom nilai numerik. Panel tabel menerima struktur kolom apa pun. Panel grafik memerlukan data waktu dan numerik. Periksa dokumentasi Grafana untuk persyaratan spesifik setiap tipe visualisasi.
Masalah impor
Data hilang setelah impor: Verifikasi bahwa koneksi sumber data diperbarui untuk semua panel dan variabel. Jangan lewatkan panel apa pun selama proses pembaruan. Periksa bahwa nama skema (raw_business_data atau raw_telematics_data) yang disebutkan dalam kueri benar untuk instansi DataHub Anda. Pastikan nama tabel dan kolom cocok dengan struktur basis data Anda.
Dashboard menampilkan kesalahan: Buka editor kueri setiap panel dan klik "Query inspector" untuk melihat pesan kesalahan terperinci. Tinjau pesan kesalahan dengan cermat—mereka sering menunjukkan masalah spesifik seperti kolom yang hilang, tipe data yang salah, atau kesalahan sintaks. Pastikan nama field dalam kueri cocok persis dengan skema DataHub Anda (nama field peka terhadap huruf besar/kecil). Verifikasi bahwa tipe data yang dikembalikan oleh kueri kompatibel dengan tipe visualisasi.
Variabel tidak terisi: Periksa bahwa Anda telah memperbarui sumber data untuk setiap variabel, bukan hanya panel visualisasi. Verifikasi kueri variabel sintaksnya benar dan mengembalikan data saat dijalankan langsung. Pastikan tipe variabel diset ke "Query" daripada "Custom" atau tipe lainnya.
Langkah berikutnya
Setelah berhasil menghubungkan Grafana ke instansi DataHub Anda:
Jelajahi skema data yang tersedia dengan meninjau Ikhtisar skema untuk memahami struktur data, hubungan antar tabel, dan field yang tersedia.
Mulailah dengan kueri sederhana yang berfokus pada entitas bisnis tertentu sebelum membangun dashboard kompleks, hal ini membantu Anda mempelajari struktur data dan menghindari masalah kinerja.
Tinjau SQL Recipe Book untuk pola kueri dan teknik optimasi yang terbukti, serta contoh skenario analitik telematika umum
Bereksperimenlah dengan berbagai tipe visualisasi (deret waktu, tabel, gauge, panel stat) untuk menemukan representasi terbaik bagi data dan kasus penggunaan spesifik Anda
Pertimbangkan membuat beberapa dashboard untuk tujuan berbeda: pemantauan real-time, analisis historis, ringkasan eksekutif, dan laporan operasional.
Dukungan
Untuk pertanyaan teknis atau bantuan dengan koneksi DataHub, hubungi dukungan di [email protected].
Last updated
Was this helpful?