# Menghubungkan Grafana Panduan ini menunjukkan cara menghubungkan Grafana ke **IoT Query** untuk memvisualisasikan data telematika dan armada. Grafana menyediakan kemampuan visualisasi yang kuat untuk memantau status kendaraan, data sensor, dan metrik lainnya secara real-time. {% hint style="info" %} Panduan ini merupakan bagian dari **IoT Query** rangkaian dokumentasi dan secara khusus membahas penghubungan Power BI ke data warehouse Anda. Jika Anda masih memutuskan alat BI mana yang akan digunakan, rujuk ke [Memilih alat BI](https://www.navixy.com/docs/analytics/datahub/connection-setup/selecting-bi-tools) ikhtisar. {% endhint %} Tonton ringkasan video singkat untuk melihat apa yang dapat dilakukan dengan **IoT Query**kombinasi +Grafana (tersedia dalam bahasa Inggris dan Spanyol): {% tabs %} {% tab title="Bahasa Inggris" %} {% embed url="" %} **IoT Query** + tutorial ringkasan dan penyiapan Grafana. {% endembed %} {% endtab %} {% tab title="Español" %} {% embed url="" %} Descripción general y tutorial de configuración de **IoT Query** + Grafana. {% endembed %} {% endtab %} {% endtabs %} ## Fitur dashboard * Visualisasi data sensor secara 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 kustom dengan SQL ## Persyaratan teknis * Grafana 9.3 atau yang lebih baru * Plugin sumber data PostgreSQL (disertakan secara default) * Akses internet untuk koneksi database * Aktif **IoT Query** instance dengan kredensial koneksi ## Instalasi dan penyiapan Grafana harus diinstal di sistem Anda sebelum Anda dapat menghubungkan **IoT Query**. {% stepper %} {% step %} #### Instal Grafana 1. Unduh dan instal Grafana dari situs web resmi:\ 2. Ikuti petunjuk instalasi untuk sistem operasi Anda. {% endstep %} {% step %} #### Unduh templat dashboard (opsional) Templat dashboard siap pakai tersedia untuk membantu Anda memulai dengan cepat tanpa harus membangun visualisasi dari awal. Templat ini dikelola di [repositori bi-intergrations](https://github.com/SquareGPS/bi-intergrations) di dalam folder `grafana` . Anda dapat mengkloning repositori tersebut untuk mengakses dashboard yang sudah jadi: ```bash git clone https://github.com/SquareGPS/bi-intergrations.git ``` Periksa `grafana` folder untuk file JSON dashboard yang tersedia. {% endstep %} {% endstepper %} ## Koneksi database Bagian Connections di Grafana adalah tempat Anda mengelola semua integrasi sumber data. {% stepper %} {% step %} #### Akses tab Connections Buka Grafana dan navigasikan ke **Connections** di bilah sisi kiri. **IoT Query** berjalan di PostgreSQL, jadi Anda perlu menambahkan sumber data PostgreSQL agar Grafana dapat mengkueri data telematika Anda. {% endstep %} {% step %} #### Tambahkan sumber data PostgreSQL Plugin sumber data PostgreSQL telah terinstal sebelumnya bersama Grafana dan menyediakan dukungan native untuk menghubungkan ke basis data PostgreSQL. Untuk menambahkan sumber data: 1. Di bagian Connections, cari **PostgreSQL** 2. Klik **Tambahkan sumber data baru** 3. Halaman konfigurasi PostgreSQL akan terbuka {% endstep %} {% step %} #### Konfigurasikan parameter koneksi Anda **IoT Query** detail koneksi berisi semua informasi yang diperlukan untuk membuat koneksi aman. Parameter ini unik untuk instance Anda dan memastikan Grafana dapat mengakses data telematika Anda. Temukan parameter koneksi Anda di akun Navixy dan **IoT Query** email selamat datang**.** **Referensi parameter koneksi** | Parameter | Bidang Konfigurasi | Deskripsi | | ---------------- | ------------------ | ------------------------------------------------------------------------------------ | | Host | `Host` | Alamat server basis data yang disediakan dalam **IoT Query** detail koneksi | | Port | `Port` | Default-nya adalah 5432 untuk PostgreSQL | | Nama basis data | `Basis data` | Nama basis data yang ditetapkan untuk Anda | | Nama pengguna | `Pengguna` | Nama pengguna basis data Anda (disebut sebagai "database user" dalam detail koneksi) | | Kata sandi | `Kata sandi` | Kata sandi basis data Anda yang aman | | Mode SSL | `Mode SSL` | Diatur ke `require` untuk koneksi aman | | Versi PostgreSQL | `Versi` | Pilih **9.3** (pengaturan yang direkomendasikan) | | {% endstep %} | | | {% step %} #### Konfigurasikan pengaturan tambahan Selain parameter koneksi esensial, Grafana menawarkan opsi konfigurasi tambahan. Bagi sebagian besar pengguna, nilai default sudah sesuai dan akan berfungsi dengan benar tanpa modifikasi. Anda dapat menyesuaikan pengaturan ini nanti berdasarkan persyaratan keamanan organisasi Anda, batasan infrastruktur, atau kebutuhan perangkat tertentu. Biarkan semua bidang lainnya pada nilai default untuk penyiapan awal. Anda tidak perlu mengaktifkan sakelar atau toggle tambahan apa pun. {% endstep %} {% step %} #### Uji koneksi Menguji koneksi sebelum menyimpan memastikan bahwa semua parameter sudah benar dan Grafana dapat berkomunikasi dengan sukses dengan **IoT Query** instans organisasi Anda. Untuk memverifikasi dan menyimpan: 1. Beri nama koneksi Anda dengan pengenal deskriptif (misalnya, "**IoT Query** Production" atau "Fleet Analytics") 2. Klik **Save & Test** untuk memverifikasi koneksi Anda 3. Pesan sukses berwarna hijau menandakan bahwa koneksi berfungsi dengan benar {% endstep %} {% endstepper %} ## Membuat visualisasi pertama Anda Membuat visualisasi pertama Anda membantu Anda memahami bagaimana Grafana melakukan kueri **IoT Query** dan menampilkan data telematika. Proses ini melibatkan pembuatan dashboard, menambahkan panel, mengonfigurasi kueri, dan memilih format visualisasi yang sesuai. {% stepper %} {% step %} **Buat dasbor baru** Dashboard di Grafana berfungsi sebagai wadah untuk beberapa visualisasi. Membuat dashboard khusus membantu Anda mengorganisasi visualisasi terkait dan menyediakan lokasi pusat untuk memantau aspek tertentu dari operasi armada Anda. Untuk membuat dashboard: 1. Buka **Dasbor** di bilah samping kiri 2. Klik **Buat Dashboard** 3. Pilih **Tambahkan visualisasi** 4. Pilih sumber data PostgreSQL yang baru saja Anda konfigurasi {% endstep %} {% step %} **Konfigurasikan kueri** Grafana menyediakan dua mode kueri: Builder visual dan editor Code. Untuk **IoT Query** koneksi, editor Code memberi Anda kontrol penuh atas kueri SQL dan direkomendasikan untuk analisis data telematika. Untuk menulis kueri Anda: 1. Di editor kueri, alihkan dari **Builder** ke **Code** mode 2. Masukkan kueri SQL Anda secara langsung Contoh kueri untuk visualisasi data sensor: ```sql SELECT device_time AS time, value::numeric AS value, sensor_name FROM raw_telematics_data.inputs WHERE sensor_name = 'temperature' AND device_id = 12345 AND $__timeFilter(device_time) ORDER BY device_time ``` Kueri ini 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 [Buku Resep SQL](https://www.navixy.com/docs/analytics/example-queries). {% endstep %} {% step %} **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, sedangkan tabel lebih baik untuk catatan yang terperinci. Untuk mengonfigurasi format: 1. Klik **Jalankan kueri** untuk memverifikasi bahwa kueri Anda mengembalikan data 2. Temukan pemilih jenis visualisasi (biasanya di kanan atas panel) 3. Ubah format dari **Tabel** ke **Time series** atau format pilihan Anda 4. 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 jenis visualisasi yang dipilih. {% endstep %} {% step %} **Simpan visualisasi Anda** Menyimpan pekerjaan Anda mempertahankan konfigurasi visualisasi dan membuatnya tersedia untuk referensi di masa mendatang. Penyimpanan secara berkala penting—Grafana tidak menyimpan perubahan secara otomatis, jadi Anda bisa kehilangan pekerjaan Anda jika beralih tanpa menyimpan. Untuk menyimpan visualisasi: 1. Klik **Simpan** 2. Berikan nama deskriptif untuk dashboard Anda 3. Pilih atau buat folder untuk pengorganisasian 4. Konfirmasikan operasi penyimpanan Dashboard kini tersedia di instance Grafana Anda dan dapat diakses melalui menu Dashboards. {% endstep %} {% endstepper %} ### Bekerja dengan variabel Variabel adalah salah satu fitur Grafana yang paling kuat untuk membuat dashboard dinamis dan interaktif. Alih-alih menanamkan nilai tertentu seperti nama sensor atau ID perangkat di kueri Anda, variabel memungkinkan pengguna memilih nilai yang berbeda dari menu dropdown tanpa mengedit SQL yang mendasarinya. Ini membuat dashboard lebih fleksibel dan lebih mudah digunakan. {% stepper %} {% step %} **Akses pengaturan variabel** Variabel dikonfigurasikan pada tingkat dashboard dan berlaku untuk semua visualisasi di dalam dashboard tersebut. Anda perlu mengakses pengaturan dashboard untuk membuat dan mengelola variabel. Untuk memulai: 1. Buka dashboard Anda 2. Klik **Settings** ikon dashboard (ikon roda gigi) di pojok kanan atas 3. Navigasikan ke bagian **Variables** di panel kiri 4. Bagian ini akan kosong jika belum ada variabel yang dibuat {% endstep %} {% step %} **Konfigurasikan variabel** Setiap variabel memerlukan nama, sumber data, dan kueri yang mengembalikan nilai yang dapat dipilih pengguna. Nilai variabel diisi secara dinamis dengan mengkueri **IoT Query** instans organisasi Anda. Untuk membuat variabel: 1. Klik **Tambah variabel** 2. Konfigurasikan pengaturan berikut: 1. **Pengaturan umum:** 1. **Nama**: `sensor_name` (gunakan pengenal yang jelas dan deskriptif tanpa spasi) 2. **Label**: Sama seperti nama untuk konsistensi, ini adalah yang dilihat pengguna di dashboard 3. **Tipe**: Pilih **Query** untuk mengisi nilai dari basis data 2. **Opsi kueri:** 1. **Sumber data**: Pilih PostgreSQL Anda **IoT Query** koneksi dari dropdown 2. **Query**: Masukkan kueri SQL untuk mengisi nilai variabel Contoh kueri untuk menampilkan semua sensor untuk perangkat tertentu: ```sql SELECT DISTINCT sensor_name FROM raw_telematics_data.inputs WHERE device_id = 12345 ORDER BY sensor_name ``` Setelah memasukkan kueri, Grafana akan mengeksekusinya segera dan menampilkan pratinjau nilai yang dikembalikan di bagian bawah halaman konfigurasi. Ini mengonfirmasi bahwa kueri Anda berfungsi dengan benar dan menunjukkan opsi apa yang akan tersedia di dropdown. {% endstep %} {% step %} **Terapkan variabel dalam kueri** Setelah variabel dibuat, Anda perlu memperbarui kueri visualisasi Anda untuk mereferensikannya. Variabel menggunakan sintaks khusus dengan awalan tanda dolar, dan Grafana secara otomatis menggantikan nilai yang dipilih saat mengeksekusi kueri. Untuk menggunakan variabel: 1. Buka visualisasi yang ingin Anda buat dinamis 2. Edit kueri 3. Ganti nilai hardcoded dengan referensi variabel Contoh kueri yang diperbarui menggunakan variabel: ```sql SELECT device_time AS time, value::numeric AS value, sensor_name FROM raw_telematics_data.inputs WHERE sensor_name = '$sensor_name' AND device_id = 12345 AND $__timeFilter(device_time) ORDER BY device_time ``` Perhatikan bagaimana `'temperature'` telah diganti dengan `'$sensor_name'`. Tanda kutip penting untuk nilai string dalam SQL. {% endstep %} {% step %} **Simpan dan uji** Menguji variabel memastikan variabel berfungsi dengan benar dan memperbarui visualisasi sesuai harapan. Pastikan untuk menyimpan pekerjaan Anda di setiap langkah untuk menghindari kehilangan perubahan konfigurasi. Untuk menyelesaikan penyiapan: 1. Klik **Terapkan** untuk menyimpan konfigurasi variabel 2. Klik **Simpan dashboard** untuk mempertahankan semua perubahan 3. Kembali ke tampilan dashboard utama 4. Temukan dropdown variabel di bagian atas dashboard 5. Pilih nama sensor yang berbeda dari dropdown 6. Amati bahwa visualisasi diperbarui secara otomatis dengan data untuk sensor yang dipilih Jika visualisasi tidak diperbarui saat Anda mengubah pilihan variabel, verifikasi bahwa nama variabel di kueri Anda benar-benar cocok dengan nama variabel yang Anda buat (nama variabel peka huruf besar/kecil). {% endstep %} {% endstepper %} ### Mengimpor dashboard siap pakai Dashboard siap pakai 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, dashboard ini memerlukan konfigurasi untuk terhubung ke **IoT Query** instans organisasi Anda. {% stepper %} {% step %} **Akses fungsi impor** Fitur impor Grafana memungkinkan Anda memuat konfigurasi dashboard dari file JSON atau langsung dari Grafana.com menggunakan ID dashboard. 1. Buka **Dasbor** 2. Klik **Baru** → **Import** 3. Jendela unggah akan muncul {% endstep %} {% step %} **Impor dashboard** Proses impor menerima konfigurasi dashboard dalam beberapa format, memberi Anda fleksibilitas dalam memuat dashboard siap pakai. Anda dapat mengimpor dashboard menggunakan: * **ID Dashboard** dari Grafana.com * **File JSON** yang diunduh dari repositori bi-intergrations * **Model JSON** ditempel langsung Jika menggunakan file JSON: 1. Klik **Unggah file JSON** 2. Pilih file dashboard 3. Berikan nama dan pilih folder tujuan 4. Klik **Import** Tunggu hingga 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. {% endstep %} {% step %} **Perbarui koneksi sumber data** Ini adalah langkah yang penting. Dashboard yang diimpor pada awalnya terhubung ke sumber data eksternal yang tidak memiliki akses ke **IoT Query** data Anda. Anda harus memperbarui setiap visualisasi untuk menggunakan PostgreSQL Anda **IoT Query** koneksi. Untuk memperbarui visualisasi: 1. Buka dashboard yang diimpor 2. Klik **Edit** pada panel visualisasi pertama (cari ikon edit atau menu tiga titik) 3. Di editor kueri, temukan pemilih sumber data 4. Ubah sumber data dari sumber asli template ke PostgreSQL Anda **IoT Query** koneksi 5. Klik **Jalankan kueri** untuk memverifikasi bahwa visualisasi berhasil mengambil data 6. Klik **Simpan** untuk mempertahankan perubahan 7. Ulangi proses ini untuk setiap panel visualisasi pada dashboard {% hint style="info" %} Simpan pekerjaan Anda secara berkala selama proses ini. Anda mungkin memiliki beberapa visualisasi untuk diperbarui, dan menyimpan setelah setiap visualisasi memastikan Anda tidak kehilangan kemajuan. {% endhint %} {% endstep %} {% step %} **Perbarui variabel dashboard** Banyak dashboard siap pakai menggunakan variabel untuk penyaringan dan interaktivitas. Variabel ini juga terhubung ke sumber data asli dan harus diperbarui untuk melakukan kueri ke **IoT Query** instans organisasi Anda. Untuk memperbarui variabel: 1. Buka **Settings** → **Variables** 2. Anda akan melihat daftar semua variabel yang digunakan di dashboard 3. Klik **Edit** pada variabel pertama 4. Temukan **Sumber data** dropdown di bagian Query options 5. Ubah ke PostgreSQL Anda **IoT Query** koneksi 6. Verifikasi bahwa pratinjau di bagian bawah menampilkan nilai yang diharapkan dari basis data Anda 7. Klik **Terapkan** untuk mengonfirmasi perubahan 8. Ulangi untuk setiap variabel dalam daftar Setelah memperbarui semua variabel, simpan dashboard lagi. Variabel sekarang seharusnya terisi dengan nilai dari **IoT Query** instans organisasi Anda. {% endstep %} {% step %} **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: 1. Simpan dashboard untuk terakhir kalinya menggunakan **Ctrl+S** atau **Simpan** tombol 2. Muat ulang halaman browser sepenuhnya (atau gunakan **F5**) 3. Periksa bahwa semua visualisasi menampilkan data dengan benar 4. Uji setiap dropdown variabel untuk memastikan variabel terisi dengan nilai 5. Pilih nilai variabel yang berbeda dan pastikan visualisasi diperbarui sesuai 6. Coba rentang waktu yang berbeda menggunakan pemilih waktu Jika ada visualisasi yang tetap kosong atau menampilkan kesalahan, kembali ke mode edit dan verifikasi sumber data serta konfigurasi kueri untuk panel tertentu tersebut. {% endstep %} {% endstepper %} ## Pemecahan masalah ### Masalah koneksi database **Kesalahan koneksi**: Verifikasi bahwa kredensial dan parameter koneksi cocok persis dengan **IoT Query** detail Anda. Periksa bahwa host, port, nama basis data, nama pengguna, dan kata sandi sudah benar. **Kesalahan firewall**: Pastikan jaringan Anda mengizinkan koneksi ke host dan port yang ditentukan. Hubungi administrator jaringan Anda jika upaya koneksi diblokir. **Kesalahan SSL/TLS**: Verifikasi bahwa mode SSL disetel ke `require` dan instance 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 saat data ada di basis data Anda. Konfirmasikan bahwa sumber data dipilih dan terhubung dengan benar. Periksa bahwa nama tabel dan kolom dalam kueri Anda cocok dengan struktur skema yang sebenarnya. **Variabel tidak berfungsi**: Verifikasi bahwa kueri variabel mengembalikan nilai dengan memeriksa pratinjau di halaman konfigurasi variabel. Pastikan referensi variabel dalam kueri Anda menggunakan sintaks yang benar (`$variable_name`) tanpa salah ketik. Periksa bahwa variabel telah disimpan dan diterapkan ke dashboard dengan benar. Jika dropdown variabel kosong, tinjau kueri SQL variabel untuk mencari kesalahan. **Kinerja kueri lambat**: Pertimbangkan untuk menambahkan indeks basis data pada kolom yang sering dikueri seperti `device_time` dan `device_id`. Batasi rentang data dengan menggunakan filter waktu yang lebih ketat. Optimalkan struktur kueri dengan hanya memilih kolom yang diperlukan alih-alih menggunakan `SELECT *`. Rujuk ke [Buku Resep SQL](https://www.navixy.com/docs/analytics/example-queries) untuk contoh optimasi kinerja dan pola kueri yang terbukti. **Ketidaksesuaian format**: Pastikan kueri Anda mengembalikan data dalam format yang diharapkan oleh jenis visualisasi Anda. Panel deret waktu memerlukan kolom yang diberi alias `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 jenis visualisasi. ### Masalah impor **Data hilang setelah impor**: Verifikasi bahwa koneksi sumber data telah diperbarui untuk semua panel dan variabel. Jangan melewatkan panel apa pun selama proses pembaruan. Periksa bahwa nama skema (`raw_business_data` atau `raw_telematics_data`) yang ditentukan dalam kueri benar untuk **IoT Query** instance Anda. Pastikan nama tabel dan kolom cocok dengan struktur basis data Anda yang sebenarnya. **Dashboard menampilkan kesalahan**: Buka editor kueri setiap panel dan klik "Query inspector" untuk melihat pesan kesalahan terperinci. Tinjau pesan kesalahan dengan cermat—pesan tersebut sering menunjukkan masalah spesifik seperti kolom yang hilang, tipe data yang salah, atau kesalahan sintaks. Pastikan nama field dalam kueri cocok persis dengan **IoT Query** skema Anda (nama field peka huruf besar/kecil). Verifikasi bahwa tipe data yang dikembalikan oleh kueri kompatibel dengan jenis visualisasi. **Variabel tidak terisi**: Periksa bahwa Anda telah memperbarui sumber data untuk setiap variabel, bukan hanya panel visualisasi. Verifikasi bahwa kueri variabel benar secara sintaks dan mengembalikan data saat dieksekusi langsung. Pastikan tipe variabel disetel ke "Query" dan bukan "Custom" atau tipe lainnya. ## Langkah berikutnya Setelah berhasil menghubungkan Grafana ke **IoT Query** instance Anda: * Jelajahi skema data yang tersedia dengan meninjau bagian [Ikhtisar schema](/docs/analytics/id/iot-query/schema-overview.md) untuk memahami struktur data, hubungan antar tabel, dan field yang tersedia. * Mulailah dengan kueri sederhana yang berfokus pada entitas bisnis tertentu sebelum membangun dashboard yang kompleks; ini membantu Anda mempelajari struktur data dan menghindari masalah kinerja. * Tinjau [Buku Resep SQL](/docs/analytics/id/example-queries.md) untuk pola kueri dan teknik optimasi yang terbukti, serta contoh skenario analitik telematika yang umum * Bereksperimenlah dengan berbagai jenis visualisasi (deret waktu, tabel, gauge, panel statistik) untuk menemukan representasi terbaik bagi data dan kasus penggunaan spesifik Anda * Pertimbangkan untuk membuat beberapa dashboard untuk tujuan yang berbeda: pemantauan real-time, analisis historis, ringkasan eksekutif, dan laporan operasional. ### Dukungan Untuk pertanyaan teknis atau bantuan dengan **IoT Query** koneksi, hubungi dukungan di . --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://navixy.com/docs/analytics/id/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.