# Анализ топливных данных с Grafana через интеграцию с Navixy API
## Введение
Иногда наши партнёры и интеграторы сталкиваются с ситуациями, когда им требуется более глубокий анализ сырых данных по топливу и связанных параметров. Такой анализ может включать изучение уровня топлива, скорости, напряжения или состояния зажигания за определённые промежутки времени и на участках карты, чтобы выявить любые аномальные события. Он также может дать представление о конфигурации датчиков, помочь диагностировать проблемы и отслеживать производительность в реальном времени. В этой статье мы рассмотрим, как интегрировать Grafana и API Navixy для простого получения и визуализации данных контроля топлива.
Grafana — это инструмент визуализации данных с открытым исходным кодом, который предлагает широкий спектр настраиваемых вариантов отображения. Его можно легко установить и настроить даже на ПК или ноутбуке. Процесс установки обычно занимает около 30 минут.
## Подключение Navixy к Grafana
Следуя этому пошаговому руководству, вы сможете без труда интегрировать Navixy с Grafana, что позволит эффективно визуализировать и анализировать ваши телематические данные.
### Шаг 1: Получение API-ключа Navixy
Начните с входа в свою учётную запись Navixy и перейдите в настройки аккаунта. В настройках найдите раздел API-ключей и сгенерируйте уникальный API-ключ. Этот ключ, например `"8f6a4353bc5114d97e2068b4e398"`, будет использоваться для аутентификации соединения между Navixy и Grafana.
### Шаг 2: Запуск Grafana
Grafana предоставляет 2 типа доступа: облачный или развёрнутый. Облачный доступ можно получить на их официальном сайте . Ниже мы рассмотрим, как установить пакет на собственный сервер или локальный компьютер.
Чтобы развернуть Grafana на локальной машине Windows, выполните следующие простые шаги:
1. Скачайте последнюю версию установщика Grafana для Windows с официальной страницы загрузки.
2. Запустите скачанный установщик (например, grafana-xx.x.x.windows-amd64.msi, где xx.x.x — номер версии) и завершите установку, следуя подсказкам.
3. После завершения установки запустите Grafana, запустив файл grafana-server.exe, расположенный в папке bin каталога установки (например, C:\Program Files\GrafanaLabs\grafana\bin).
4. Откройте веб-браузер и перейдите по адресу [http://localhost:3000](http://localhost:3000/). Используйте учётные данные по умолчанию: "admin" и в качестве имени пользователя, и в качестве пароля.
5. После входа в систему вы можете сразу начать создавать и настраивать панели мониторинга, используя различные источники данных для визуализации и анализа ваших данных.
Для установок на Linux/Mac или если вы предпочитаете использовать версию Grafana для Docker, обратитесь к официальной документации Grafana за подробными инструкциями, адаптированными к вашей конкретной конфигурации.
### Шаг 3: Установка плагина источника данных JSON API
После запуска Grafana перейдите в меню "Connections" или "Plugins" в интерфейсе Grafana. Найдите плагин источника данных "JSON API" и выберите его. Установите плагин, следуя предоставленным инструкциям. Этот плагин имеет решающее значение для установления связи между Grafana и API Navixy.
### Шаг 4: Настройка соединения источника данных JSON API
После установки плагина "JSON API" ваш экземпляр Grafana готов к подключению к API Navixy с использованием API-ключа.
Выполните следующие шаги, чтобы настроить соединение:
1. Перейдите в меню "Connections" слева
2. Найдите "JSON API" и выберите этот источник
3. Нажмите "Create a JSON API data source"
4. Заполните следующие поля:
* Name: Выберите предпочитаемое имя для источника данных
* URL: Введите URL API Navixy. В зависимости от расположения вашей платформы используйте один из следующих URL:
* `https://api.eu.navixy.com/v2/` для Европы
* `https://api.us.navixy.com/v2/` для Северной Америки
* `` для установок на собственном хостинге (On-Premise). Формат по умолчанию обычно такой: `http(s)://your_configured_domain/api/`
* Query string: Используйте строку запроса в формате `hash=[YOUR_API_KEY]&iso_datetime=true`. Например: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.
5. Настройте любые дополнительные параметры по мере необходимости, а затем нажмите "Save & Test", чтобы проверить соединение.
### Шаг 5: Импорт шаблона панели мониторинга Navixy
Чтобы ускорить процесс настройки, импортируйте [шаблон панели мониторинга Navixy](https://github.com/SquareGPS/bi-intergrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) в Grafana. Откройте раздел управления панелями мониторинга Grafana, создайте новую панель и выберите опцию импорта панели. Загрузите предоставленный файл шаблона панели мониторинга Navixy. Проверьте параметры импорта, включая назначенный источник данных, и завершите процесс импорта.
## Анализ телематических данных с помощью Grafana
Grafana предоставляет полный набор объектов и инструментов визуализации, позволяя специалистам по телематике без труда анализировать и интерпретировать сложные телематические данные. Давайте подробнее рассмотрим основные элементы демо-панели мониторинга, предоставляемой Navixy, которые отмечены синим цветом.
### Трекеры и датчики для анализа
Для начала на демо-панели мониторинга выберите нужное устройство с помощью селектора "Tracker". После выбора вы можете создать несколько линейных графиков на одном холсте, выбрав нужные датчики в селекторах "Sensor 1" и "Sensor 2". Выберите “True” в раскрывающихся списках “Raw Data 1” / “Raw data 2”, если хотите анализировать сырые данные датчиков.
### Диапазон времени
В правом верхнем углу вы найдёте опцию выбора диапазона дат для анализа. Это даёт вам гибкость при выборе между быстрыми диапазонами, которые предоставляют предопределённые временные интервалы, и абсолютным диапазоном времени, где вы можете указать конкретные даты начала и окончания.
### Линейные графики
Grafana предлагает ряд мощных вариантов визуализации, и среди них особенно выделяется линейный график. Этот график позволяет проводить всесторонний анализ показаний датчиков во времени, что крайне полезно для специалистов по телематике. Нанося телематические данные, такие как уровень топлива, скорость автомобиля и т. д., на линейный график, пользователи получают возможность выявлять закономерности, тенденции и аномалии, которые могут влиять на эффективность автопарка. Интерактивные функции, такие как масштабирование и панорамирование, позволяют специалистам углубляться в конкретные временные периоды и тем самым извлекать более глубокие сведения из данных.
### Таблицы
Таблицы панели мониторинга предоставляют структурированный и удобный для пользователя формат для изучения сырых данных датчиков. Каждое значение сопровождается меткой времени, что позволяет пользователям легко отслеживать, когда были сгенерированы данные. Такое упорядоченное представление облегчает всесторонний анализ отдельных точек данных, обеспечивая детальное изучение и получение выводов. Демо-панель мониторинга Navixy содержит 2 таблицы: сырые данные датчиков по временным меткам и завершённые поездки с деталями.
### Просмотр карты
Отображение карты Grafana позволяет отслеживать объекты и события на карте, предоставляя ценные сведения о местоположении транспортных средств и поездках в выбранном диапазоне времени. Эта мощная функция обеспечивает комплексную визуализацию прошлых перемещений транспортных средств, позволяя пользователям анализировать исторические данные и глубже понимать работу автопарка. В дополнение к визуальному представлению сопутствующая таблица отображает точные показатели, такие как длина поездки и средняя скорость, что улучшает общий анализ.
## Результат и дальнейшие шаги
Интеграция API Grafana и Navixy предлагает мощное решение для визуализации и анализа телематических данных, связанных с контролем топлива. Используя возможности визуализации данных Grafana с открытым исходным кодом и обширный API Navixy, пользователи могут получать ценные сведения о расходе топлива своего автопарка, отслеживать аномальные события и эффективно устранять неполадки.
### Настройка панели мониторинга
Как интегратор, вы имеете возможность настраивать элементы панели мониторинга в соответствии с вашими конкретными требованиями. Grafana предоставляет различные объекты визуализации, которые можно настроить для доступа к полному набору телематических данных из API Navixy. Это включает выбор и настройку различных [визуализаций Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) для анализа временных рядов и других типов данных, позволяя вам исследовать данные более осмысленным образом. Используя настраиваемые панели мониторинга, пользователи могут создавать персонализированные визуализации, отвечающие их конкретным потребностям в анализе. Это даёт руководителям автопарков и заинтересованным сторонам возможность отслеживать производительность в реальном времени, диагностировать проблемы и принимать обоснованные решения на основе проанализированных данных. Настройка панели мониторинга требует опыта работы с API Navixy и форматом JSON.
### Обмен панелями мониторинга Grafana
Делиться своей настроенной панелью мониторинга с другими в Grafana — это простой процесс. Совместное использование настроенных панелей с членами команды, клиентами или заинтересованными сторонами усиливает сотрудничество и обмен знаниями. Для начала вы можете экспортировать свою панель мониторинга в файл JSON, который включает всю необходимую информацию, требуемую для воссоздания панели в другом экземпляре Grafana. Эта упрощённая функция обмена гарантирует, что все участники смогут получить доступ к выводам и аналитике панели мониторинга и извлечь из них пользу.
---
# 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/ru/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.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.