> 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.

## Pengantar

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 mencakup pemeriksaan level bahan bakar, kecepatan, tegangan, atau status pengapian selama kerangka waktu dan area tertentu pada 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 beragam opsi visualisasi yang dapat disesuaikan. Alat ini dapat dengan mudah diinstal dan dikonfigurasi bahkan di PC atau laptop Anda. Proses instalasi biasanya memakan waktu 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: memperoleh Kunci API Navixy

Mulailah dengan masuk ke akun Navixy Anda dan membuka **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: meluncurkan Grafana

Grafana menyediakan 2 jenis akses: cloud atau terpasang. Akses cloud dapat diperoleh di situs web resmi mereka <https://grafana.com/>. Di bawah ini, kami akan membahas cara memasang paket pada server Anda sendiri atau komputer lokal.

Untuk memasang Grafana di 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 buka [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 suka menggunakan versi Docker Grafana, lihat dokumentasi resmi Grafana untuk petunjuk terperinci yang disesuaikan dengan penyiapan spesifik Anda.

### Langkah 3: memasang plugin Sumber Data JSON API

Setelah Grafana diluncurkan, lanjutkan ke **Koneksi** atau **Plugin** menu di antarmuka Grafana. Cari **JSON API** plugin Sumber Data dan pilih itu. Instal plugin ini mengikuti instruksi 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 sebuah** sumber data JSON API
4. Isi bidang-bidang berikut:

* Nama: Pilih nama yang diinginkan 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
  * `<your_configured_domain_api_url>` untuk instalasi mandiri (On-Premise). Format bawaan biasanya `http(s)://your_configured_domain/api/`
* String kueri: Gunakan string kueri dalam 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.

![Grafana dan API Navixy - memilih Sumber Data](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-221627e84bfc36d7ad4c9a32dc1fd899de80f956%2Fimage-20231017-075916.png?alt=media)

![Grafana dan API Navixy - menyiapkan Sumber Data](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-754d84661ef8e5cb10b8d1318ebd4a474a4ca9bf%2Fimage-20231017-080330.png?alt=media)

### Langkah 5: mengimpor templat dasbor Navixy

Untuk mempercepat proses penyiapan, impor Navixy [templat dasbor](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) ke dalam Grafana. Buka bagian pengelolaan dasbor Grafana, buat dasbor baru, dan pilih opsi untuk mengimpor dasbor. Unggah file templat dasbor Navixy yang disediakan. Tinjau pengaturan impor, termasuk Sumber Data yang ditetapkan, lalu selesaikan proses impor.

## Menganalisis data telematika dengan Grafana

Grafana menyediakan seperangkat lengkap objek dan alat visualisasi, sehingga memungkinkan profesional telematika untuk dengan mudah menganalisis dan menafsirkan data telematika yang kompleks. Mari kita telaah elemen utama dasbor demo yang ditawarkan oleh Navixy yang ditandai dengan warna biru.

![](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-4dad2c18d89bcb81bd5c8af37a72b60cd6e4a654%2Fimage-20231017-083157.png?alt=media)

### Perangkat dan sensor untuk dianalisis

Untuk memulai, pada dasbor demo, pilih perangkat yang diinginkan menggunakan pemilih pelacak. **pelacak** Setelah dipilih, Anda dapat membuat beberapa bagan garis pada kanvas yang sama dengan memilih sensor yang diinginkan dalam pemilih yang dihasilkan dan pemilih yang dihasilkan. Pilih pada **Data Mentah 1** / **Data Mentah 2** menu tarik-turun jika Anda ingin menganalisis data mentah sensor.

### Rentang waktu

Di pojok 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, atau rentang waktu absolut, tempat Anda dapat menentukan tanggal mulai dan tanggal selesai tertentu.

### Diagram garis

Grafana menawarkan serangkaian opsi visualisasi yang andal, dan di antaranya, diagram garis menonjol. Diagram ini memungkinkan analisis menyeluruh terhadap pembacaan sensor dari waktu ke waktu, yang terbukti sangat berharga bagi profesional telematika. Dengan memplot data telematika seperti level bahan bakar, kecepatan kendaraan, dan sebagainya pada diagram garis, pengguna memperoleh kemampuan untuk mengidentifikasi pola, tren, dan anomali yang dapat memengaruhi kinerja Armada. Fitur interaktif, seperti memperbesar dan menggeser tampilan, memungkinkan profesional menelusuri periode waktu tertentu, sehingga menghasilkan wawasan yang lebih dalam dari data.

### Tabel

Tabel pada dasbor menyediakan format yang terstruktur dan mudah digunakan untuk menjelajahi data sensor mentah. Setiap nilai disertai dengan stempel waktu, sehingga pengguna dapat dengan mudah melacak kapan data dihasilkan. Penyajian yang terorganisasi ini memfasilitasi analisis menyeluruh terhadap 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 selesai beserta detailnya.

### Peta

Tampilan peta Grafana memfasilitasi pemantauan objek dan peristiwa pada 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 menampilkan metrik yang tepat seperti panjang Perjalanan dan kecepatan rata-rata, sehingga meningkatkan keseluruhan analisis.

## Hasil dan langkah selanjutnya

Integrasi API Grafana dan 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 dikonfigurasi untuk mengakses seperangkat lengkap data telematika dari API Navixy. Ini mencakup memilih dan mengonfigurasi beragam [visualisasi Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) untuk menganalisis deret waktu dan jenis data lainnya, sehingga Anda dapat menjelajahi data dengan cara yang lebih bermakna. Dengan memanfaatkan dasbor yang dapat disesuaikan, pengguna dapat membuat visualisasi personal yang sesuai dengan kebutuhan analisis spesifik mereka. Hal ini memberdayakan manajer Armada dan pemangku kepentingan untuk memantau kinerja waktu nyata, 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 Anda sesuaikan dengan orang lain di Grafana adalah proses yang mulus. Dengan membagikan dasbor yang disesuaikan kepada 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 lainnya. Fitur berbagi yang efisien ini memastikan bahwa semua pihak yang terlibat dapat mengakses dan memanfaatkan wawasan serta 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
