> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/id/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md).
# Analisis data bahan bakar dengan Grafana melalui integrasi API Navixy
Visualisasikan data bahan bakar dan telematika di Grafana dengan terhubung ke API Navixy. Penyiapan langkah demi langkah untuk dasbor yang melacak konsumsi historis.
## Pendahuluan
Terkadang mitra dan integrator kami menghadapi situasi ketika mereka memerlukan analisis yang lebih mendalam terhadap data mentah bahan bakar dan parameter terkait. Analisis ini dapat melibatkan pemeriksaan level bahan bakar, kecepatan, tegangan, atau status pengapian pada rentang waktu dan area tertentu di peta untuk mengidentifikasi peristiwa abnormal apa pun. Analisis ini juga dapat memberikan wawasan tentang konfigurasi sensor, mendiagnosis masalah, dan memantau kinerja waktu nyata. Dalam artikel ini, kami akan membahas cara mengintegrasikan Grafana dan API Navixy untuk mengambil dan memvisualisasikan data kontrol bahan bakar dengan mudah.
Grafana adalah alat visualisasi data sumber terbuka yang menawarkan berbagai opsi visualisasi yang dapat disesuaikan. Alat ini dapat dipasang dan dikonfigurasi dengan mudah bahkan di PC atau laptop Anda. Proses instalasi biasanya memerlukan sekitar 30 menit.
## Menghubungkan Navixy dengan Grafana
Dengan mengikuti panduan langkah demi langkah ini, Anda dapat mengintegrasikan Navixy dengan Grafana secara mulus, sehingga Anda dapat memvisualisasikan dan menganalisis data telematika Anda secara efektif.
### Langkah 1: mendapatkan kunci API Navixy
Mulailah dengan masuk ke akun Navixy Anda dan buka **Pengaturan akun**. Temukan bagian **Kunci API** dan buat kunci API unik. Kunci ini, seperti `"8f6a4353bc5114d97e2068b4e398"`, akan digunakan untuk mengautentikasi koneksi antara Navixy dan Grafana.
### Langkah 2: menjalankan Grafana
Grafana menyediakan 2 jenis akses: cloud atau terpasang secara lokal. Akses cloud dapat diperoleh di situs web resmi mereka . Di bawah ini, kita akan membahas cara memasang paket ini di server Anda sendiri atau komputer lokal.
Untuk menerapkan Grafana pada mesin Windows lokal, ikuti langkah-langkah sederhana berikut:
1. Unduh penginstal Grafana terbaru untuk Windows dari halaman unduhan resmi.
2. Jalankan penginstal yang telah diunduh (misalnya, grafana-xx.x.x.windows-amd64.msi, dengan xx.x.x sebagai nomor versi) dan selesaikan instalasi dengan mengikuti petunjuk.
3. Setelah instalasi selesai, mulai Grafana dengan menjalankan file grafana-server.exe yang terletak di folder bin dari direktori instalasi (misalnya, C:\Program Files\GrafanaLabs\grafana\bin).
4. Buka peramban web dan akses [http://localhost:3000](http://localhost:3000/). Gunakan kredensial masuk bawaan "admin" untuk nama pengguna dan kata sandi.
5. Setelah masuk, Anda dapat segera mulai membuat dan menyesuaikan dasbor, memanfaatkan berbagai sumber data untuk memvisualisasikan dan menganalisis data Anda.
Untuk instalasi Linux/Mac atau jika Anda lebih memilih menggunakan versi Docker dari Grafana, rujuk dokumentasi resmi Grafana untuk petunjuk terperinci yang disesuaikan dengan penyiapan spesifik Anda.
### Langkah 3: memasang plugin sumber data JSON API
Setelah Grafana dijalankan, lanjutkan ke menu **Koneksi** atau **Plugin** di antarmuka Grafana. Cari plugin sumber data **JSON API** dan pilih itu. Pasang plugin mengikuti petunjuk yang diberikan. Plugin ini sangat penting untuk membangun komunikasi antara Grafana dan API Navixy.
### Langkah 4: menyiapkan koneksi sumber data JSON API
Setelah memasang **JSON API** plugin, instans Grafana Anda siap terhubung dengan API Navixy menggunakan kunci API.
Ikuti langkah-langkah berikut untuk menyiapkan koneksi:
1. Buka **Koneksi** menu di sisi kiri
2. Cari **JSON API** dan pilih sumber ini
3. Klik **Buat sumber data JSON API** sumber data
4. Isi kolom berikut:
* Nama: Pilih nama yang Anda inginkan untuk sumber data
* URL: Masukkan URL untuk API Navixy. Bergantung pada lokasi platform Anda, gunakan salah satu URL berikut:
* `https://api.eu.navixy.com/v2/` untuk Eropa
* `https://api.us.navixy.com/v2/` untuk Amerika Utara
* `` untuk instalasi yang di-host sendiri (On-Premise). Format defaultnya biasanya `http(s)://your_configured_domain/api/`
* String kueri: Gunakan string kueri dengan format `hash=[YOUR_API_KEY]&iso_datetime=true`. Sebagai contoh: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.
5. Sesuaikan pengaturan tambahan apa pun sesuai kebutuhan, lalu klik **Simpan & Uji** untuk memverifikasi koneksi.
### Langkah 5: mengimpor template dasbor Navixy
Untuk mempercepat proses penyiapan, impor Navixy [template dasbor](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) ke dalam Grafana. Akses bagian pengelolaan dasbor Grafana, buat dasbor baru, dan pilih opsi untuk mengimpor dasbor. Unggah file template dasbor Navixy yang disediakan. Tinjau pengaturan impor, termasuk sumber data yang ditetapkan, dan selesaikan proses impor.
## Menganalisis data telematika dengan Grafana
Grafana menyediakan seperangkat lengkap objek dan alat visualisasi, sehingga para profesional telematika dapat menganalisis dan menafsirkan data telematika yang kompleks dengan mudah. Mari kita telusuri elemen-elemen utama dasbor demo yang ditawarkan oleh Navixy yang ditandai dengan warna biru.
### Perangkat dan sensor untuk dianalisis
Untuk memulai, pada dasbor demo, pilih perangkat yang diinginkan menggunakan **pelacak** pemilih pelacak. Setelah dipilih, Anda dapat membuat beberapa grafik garis pada kanvas yang sama dengan memilih sensor yang diinginkan pada pemilih yang tersedia. Pilih menu tarik-turun Raw Data 1 dan Raw data 2 jika Anda ingin menganalisis data mentah sensor. **Raw Data 1** / **Raw data 2** menu tarik-turun jika Anda ingin menganalisis data mentah sensor.
### Rentang waktu
Di sudut kanan atas, Anda akan menemukan opsi untuk memilih rentang tanggal bagi analisis Anda. Ini memberi Anda fleksibilitas dalam memilih antara rentang cepat, yang menyediakan interval waktu yang telah ditentukan sebelumnya, atau rentang waktu absolut, tempat Anda dapat menentukan tanggal mulai dan tanggal akhir tertentu.
### Grafik garis
Grafana menawarkan berbagai opsi visualisasi yang kuat, dan di antaranya, grafik garis menonjol. Grafik ini memungkinkan analisis menyeluruh atas pembacaan sensor dari waktu ke waktu, yang sangat berharga bagi para profesional telematika. Dengan memplot data telematika seperti level bahan bakar, kecepatan kendaraan, dan sebagainya pada grafik garis, pengguna memperoleh kemampuan untuk mengidentifikasi pola, tren, dan anomali yang dapat memengaruhi kinerja armada. Fitur interaktif, seperti pembesaran dan pergeseran tampilan, memungkinkan para profesional menyelami periode waktu tertentu, sehingga memperoleh wawasan yang lebih mendalam dari data.
### Tabel
Tabel dasbor menyediakan format yang terstruktur dan mudah digunakan untuk menjelajahi data mentah sensor. Setiap nilai disertai stempel waktu, sehingga pengguna dapat dengan mudah melacak kapan data dihasilkan. Penyajian yang terorganisasi ini memudahkan analisis menyeluruh atas titik data individual, sehingga memungkinkan pemeriksaan dan wawasan yang terperinci. Dasbor demo Navixy memiliki 2 tabel: Data mentah sensor berdasarkan stempel waktu dan Perjalanan yang telah selesai beserta detail.
### Peta
Tampilan peta Grafana memudahkan pemantauan objek dan peristiwa di peta, memberikan wawasan berharga tentang lokasi kendaraan dan perjalanan dalam rentang waktu yang dipilih. Fitur yang kuat ini menyediakan visualisasi menyeluruh atas pergerakan kendaraan sebelumnya, memberdayakan pengguna untuk menganalisis data historis dan mengembangkan pemahaman yang lebih mendalam tentang operasi armada. Sebagai pelengkap representasi visual, tabel pendamping menyajikan metrik yang presisi seperti panjang perjalanan dan kecepatan rata-rata, sehingga meningkatkan analisis secara keseluruhan.
## Hasil dan langkah berikutnya
Integrasi Grafana dan API Navixy menawarkan solusi yang kuat untuk memvisualisasikan dan menganalisis data telematika yang terkait dengan kontrol bahan bakar. Dengan memanfaatkan kemampuan visualisasi data sumber terbuka Grafana dan API Navixy yang luas, pengguna dapat memperoleh wawasan berharga tentang konsumsi bahan bakar armada mereka, memantau peristiwa abnormal, dan memecahkan masalah secara efektif.
### Kustomisasi dasbor
Sebagai integrator, Anda memiliki fleksibilitas untuk menyesuaikan elemen dasbor agar sesuai dengan kebutuhan spesifik Anda. Grafana menyediakan berbagai objek visualisasi yang dapat dikonfigurasikan untuk mengakses serangkaian data telematika yang komprehensif dari API Navixy. Ini mencakup pemilihan dan pengonfigurasian berbagai [visualisasi Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) untuk menganalisis data deret waktu dan jenis data lainnya, sehingga memungkinkan Anda menjelajahi data dengan cara yang lebih bermakna. Dengan memanfaatkan dasbor yang dapat disesuaikan, pengguna dapat membuat visualisasi personal yang memenuhi kebutuhan analisis spesifik mereka. Ini memberdayakan manajer armada dan para pemangku kepentingan untuk memantau kinerja secara real time, mendiagnosis masalah, dan membuat keputusan yang tepat berdasarkan data yang dianalisis. Kustomisasi dasbor memerlukan pengalaman dalam menggunakan API Navixy dan bekerja dengan format JSON.
### Berbagi dasbor Grafana
Berbagi dasbor yang telah Anda sesuaikan dengan orang lain di Grafana adalah proses yang mulus. Dengan berbagi dasbor yang telah disesuaikan dengan anggota tim, klien, atau pemangku kepentingan, kolaborasi dan berbagi pengetahuan menjadi lebih baik. Untuk memulai, Anda dapat mengekspor dasbor Anda sebagai file JSON, yang mencakup semua informasi penting yang diperlukan untuk mereplikasi dasbor pada instans Grafana lain. Fitur berbagi yang efisien ini memastikan bahwa semua pihak yang terlibat dapat mengakses dan memanfaatkan wawasan dan analisis dasbor.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/expert-center/id/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.