# Analisis data bahan bakar dengan Grafana melalui integrasi Navixy API

## Pendahuluan

Terkadang mitra dan integrator kami menghadapi situasi di mana 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 dalam rentang 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 secara real-time. 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: Mendapatkan kunci API Navixy

Mulailah dengan masuk ke akun Navixy Anda dan membuka Pengaturan akun. Di dalam pengaturan, cari bagian untuk 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. Akses cloud dapat diperoleh di situs web resminya <https://grafana.com/>. Di bawah ini kami akan membahas cara menginstal paket di server Anda sendiri atau komputer lokal.

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

1. Unduh installer Grafana terbaru untuk Windows dari halaman unduhan resmi.
2. Jalankan installer yang diunduh (misalnya, grafana-xx.x.x.windows-amd64.msi, di mana xx.x.x adalah 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 pada direktori instalasi (misalnya, C:\Program Files\GrafanaLabs\grafana\bin).
4. Buka peramban web dan buka [http://localhost:3000](http://localhost:3000/). Gunakan kredensial login default "admin" untuk nama pengguna dan kata sandi.
5. Setelah masuk, Anda dapat langsung mulai membuat dan menyesuaikan dashboard, dengan memanfaatkan berbagai sumber data untuk memvisualisasikan dan menganalisis data Anda.

Untuk instalasi Linux/Mac atau jika Anda lebih suka menggunakan versi Docker dari Grafana, lihat dokumentasi resmi Grafana untuk petunjuk terperinci yang disesuaikan dengan konfigurasi spesifik Anda.

### Langkah 3: Menginstal plugin sumber data JSON API

Setelah Grafana dijalankan, lanjutkan ke menu "Connections" atau "Plugins" di antarmuka Grafana. Cari plugin sumber data "JSON API" dan pilih. Instal plugin 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 menginstal plugin "JSON API", instance Grafana Anda siap terhubung dengan API Navixy menggunakan kunci API.

Ikuti langkah-langkah berikut untuk menyiapkan koneksi:

1. Buka menu "Connections" di sisi kiri
2. Cari "JSON API" dan pilih sumber ini
3. Klik "Create a JSON API data source"
4. Isi kolom berikut:

* Name: 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 self-hosted (On-Premise). Format default biasanya `http(s)://your_configured_domain/api/`
* Query string: Gunakan query string dalam format `hash=[YOUR_API_KEY]&iso_datetime=true`. Contohnya: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.

5. Sesuaikan pengaturan tambahan apa pun sesuai kebutuhan, lalu klik "Save & Test" untuk memverifikasi koneksi.

![Grafana dan API Navixy - memilih sumber data](/files/99cbab90a0b27e385024318d13d5a66e0eb4a195)

![Grafana dan API Navixy - menyiapkan sumber data](/files/f22195ee57d51aedb610270f9c2e19f4e9b86152)

### Langkah 5: Mengimpor templat dashboard Navixy

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

## Menganalisis data telematika dengan Grafana

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

![](/files/399fa8e7a48f5f7db4c63b1982e00c11eba1a664)

### Tracker dan sensor untuk dianalisis

Untuk memulai, pada dashboard demo, pilih perangkat yang diinginkan menggunakan pemilih "Tracker". Setelah dipilih, Anda dapat membuat beberapa grafik garis pada kanvas yang sama dengan memilih sensor yang diinginkan di pemilih "Sensor 1" dan "Sensor 2". Pilih “True” pada menu tarik-turun “Raw Data 1” / “Raw data 2” jika Anda ingin menganalisis data mentah sensor.

### Rentang waktu

Di pojok kanan atas, Anda akan menemukan opsi untuk memilih rentang tanggal untuk analisis Anda. Ini memberi Anda fleksibilitas dalam memilih antara rentang cepat, yang menyediakan interval waktu yang telah ditentukan sebelumnya, atau rentang waktu absolut, di mana Anda dapat menentukan tanggal mulai dan berakhir tertentu.

### Grafik garis

Grafana menawarkan berbagai opsi visualisasi yang kuat, dan di antaranya, grafik garis menonjol. Grafik ini memungkinkan analisis komprehensif atas pembacaan sensor dari waktu ke waktu, yang terbukti 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 zoom dan pan, memungkinkan para profesional untuk menelusuri periode waktu tertentu, sehingga memperoleh wawasan yang lebih mendalam dari data.

### Tabel

Tabel pada dashboard menyediakan format yang terstruktur dan mudah digunakan untuk menelusuri data mentah sensor. Setiap nilai disertai stempel waktu, sehingga pengguna dapat dengan mudah melacak kapan data dihasilkan. Penyajian yang terorganisasi ini memfasilitasi analisis menyeluruh terhadap titik data individual, memungkinkan pemeriksaan dan wawasan yang lebih rinci. Dashboard demo Navixy memiliki 2 tabel: Data mentah sensor berdasarkan stempel waktu dan Track yang selesai beserta detailnya.

### Tampilan peta

Tampilan peta Grafana memudahkan 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 komprehensif 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 akurat 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 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 dashboard

Sebagai integrator, Anda memiliki fleksibilitas untuk menyesuaikan elemen dashboard 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 memungkinkan Anda mengeksplorasi data dengan cara yang lebih bermakna. Dengan memanfaatkan dashboard yang dapat disesuaikan, pengguna dapat membuat visualisasi personal yang sesuai dengan kebutuhan analisis spesifik mereka. Hal 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 dashboard memerlukan pengalaman dalam menggunakan API Navixy dan bekerja dengan format JSON.

### Berbagi dashboard Grafana

Berbagi dashboard yang telah Anda sesuaikan dengan orang lain di Grafana adalah proses yang mulus. Dengan membagikan dashboard yang disesuaikan kepada anggota tim, klien, atau pemangku kepentingan, kolaborasi dan berbagi pengetahuan menjadi lebih baik. Untuk memulai, Anda dapat mengekspor dashboard Anda sebagai file JSON, yang mencakup semua informasi penting yang diperlukan untuk mereplikasi dashboard pada instance Grafana lain. Fitur berbagi yang efisien ini memastikan bahwa semua pihak yang terlibat dapat mengakses dan memperoleh manfaat dari wawasan dan analisis dashboard.


---

# 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/expert-center/id/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md?ask=<question>
```

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.
