> 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

## Pendahuluan

Terkadang mitra dan integrator kami menghadapi situasi ketika mereka memerlukan analisis yang lebih mendalam atas data mentah bahan bakar dan parameter terkait. Analisis ini dapat mencakup pemeriksaan level bahan bakar, kecepatan, tegangan, atau status pengapian selama rentang waktu tertentu dan area tertentu di Peta untuk mengidentifikasi setiap peristiwa abnormal. Analisis ini juga dapat memberikan wawasan tentang konfigurasi sensor, mendiagnosis masalah, dan memantau kinerja secara 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. Grafana dapat dipasang dan dikonfigurasi dengan mudah bahkan di PC atau laptop Anda. Proses pemasangan 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: mendapatkan kunci API Navixy

Mulailah dengan masuk ke akun Navixy Anda dan buka **Pengaturan akun**. Temukan **Kunci API** bagian tersebut 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: berbasis awan atau lokal. Akses berbasis awan dapat diperoleh di situs web resmi mereka <https://grafana.com/>. Di bawah ini kami akan membahas cara memasang paket di server Anda sendiri atau komputer lokal.

Untuk memasang Grafana di mesin Windows lokal, ikuti langkah-langkah sederhana berikut:

1. Unduh pemasang Grafana terbaru untuk Windows dari halaman unduhan resmi.
2. Jalankan pemasang yang telah diunduh (misalnya, grafana-xx.x.x.windows-amd64.msi, di mana xx.x.x adalah nomor versi) dan selesaikan pemasangan dengan mengikuti petunjuk.
3. Setelah pemasangan selesai, jalankan Grafana dengan menjalankan berkas grafana-server.exe yang terletak di folder bin pada direktori pemasangan (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, dengan 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 konfigurasi spesifik Anda.

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

Setelah Grafana dijalankan, lanjut ke **Koneksi** atau **Plugin** menu di antarmuka Grafana. Cari **JSON API** plugin Sumber Data dan pilih itu. Pasang plugin tersebut dengan 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 JSON API** Sumber Data
4. Isi bidang-bidang 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
  * `<your_configured_domain_api_url>` untuk instalasi swakelola (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](/files/ede67b54dea881d1889abf9aca8e339891165664)

![Grafana dan API Navixy - menyiapkan Sumber Data](/files/d714a14195a45f173c65d7c5ca20f9fe6a4eded5)

### 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. Akses bagian manajemen dasbor Grafana, buat dasbor baru, dan pilih opsi untuk mengimpor dasbor. Unggah berkas templat dasbor Navixy yang disediakan. Tinjau pengaturan impor, termasuk Sumber Data yang ditetapkan, dan selesaikan proses impor.

## Menganalisis data telematika dengan Grafana

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

![](/files/639254fcfcd38bfd1f337985725497e91cb082fa)

### Perangkat dan sensor untuk dianalisis

Untuk memulai, pada dasbor demo, pilih perangkat yang diinginkan menggunakan **pelacak** pemilih. Setelah dipilih, Anda dapat membuat beberapa diagram garis pada kanvas yang sama dengan memilih sensor yang diinginkan pada pemilih yang muncul. Pilih pada menu tarik-turun **Data mentah 1** / **dan Data mentah 2**  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 untuk 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.

### Diagram garis

Grafana menawarkan berbagai opsi visualisasi yang canggih, dan di antaranya, diagram garis menonjol. Diagram 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, dll. 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 para profesional menelusuri 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 memfasilitasi 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 jejak yang telah 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. Melengkapi representasi visual, tabel pendamping menyajikan metrik yang tepat seperti panjang perjalanan dan kecepatan rata-rata, sehingga meningkatkan analisis secara keseluruhan.

## Hasil dan langkah selanjutnya

Integrasi API Grafana dan Navixy menawarkan solusi yang kuat untuk memvisualisasikan dan menganalisis data telematika terkait 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 data telematika yang komprehensif dari API Navixy. Ini mencakup pemilihan dan konfigurasi berbagai [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 memenuhi kebutuhan analisis spesifik mereka. Ini memberdayakan manajer armada dan pemangku kepentingan untuk memantau kinerja secara waktu nyata, mendiagnosis masalah, dan membuat keputusan yang tepat berdasarkan data yang dianalisis. Kustomisasi dasbor memerlukan pengalaman 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 meningkat. Untuk memulai, Anda dapat mengekspor dasbor Anda sebagai berkas 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 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 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=<question>&goal=<endgoal>
```

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