> 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/ru/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md).
# Анализ данных по топливу в Grafana через интеграцию с API Navixy
Визуализируйте данные по топливу и телематике в Grafana, подключившись к API Navixy. Пошаговая настройка дашбордов для отслеживания исторического расхода.
## Введение
Иногда наши партнеры и интеграторы сталкиваются с ситуациями, когда им требуется более глубокий анализ сырых данных по топливу и связанных параметров. Такой анализ может включать изучение уровня топлива, скорости, напряжения или статуса зажигания за определенные промежутки времени и по областям на карте, чтобы выявить любые аномальные события. Он также может дать представление о настройках датчиков, помочь диагностировать проблемы и отслеживать производительность в реальном времени. В этой статье мы рассмотрим, как интегрировать 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 перейдите в **Подключения** или **Плагины** меню в интерфейсе Grafana. Найдите **JSON API** плагин источника данных и выберите его. Установите плагин, следуя приведенным инструкциям. Этот плагин имеет решающее значение для установления связи между Grafana и API Navixy.
### Шаг 4: настройка подключения источника данных JSON API
После установки **JSON API** плагина ваш экземпляр Grafana готов к подключению к API Navixy с использованием API-ключа.
Выполните следующие шаги, чтобы настроить подключение:
1. Перейдите в **Подключения** меню слева
2. Найдите **JSON API** и выберите этот источник
3. Нажмите **Создайте JSON API** источник данных
4. Заполните следующие поля:
* Имя: Выберите предпочитаемое имя для источника данных
* 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/`
* Строка запроса: используйте строку запроса в формате `hash=[YOUR_API_KEY]&iso_datetime=true`. Например: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.
5. Настройте любые дополнительные параметры по мере необходимости, а затем нажмите **Сохранить и протестировать** чтобы проверить подключение.
### Шаг 5: импорт шаблона панели мониторинга Navixy
Чтобы ускорить процесс настройки, импортируйте Navixy [шаблон панели мониторинга](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) в Grafana. Перейдите в раздел управления панелями мониторинга Grafana, создайте новую панель мониторинга и выберите вариант импорта панели мониторинга. Загрузите предоставленный файл шаблона панели мониторинга Navixy. Проверьте параметры импорта, включая назначенный источник данных, и завершите процесс импорта.
## Анализ данных телематики с помощью Grafana
Grafana предоставляет полный набор объектов и инструментов визуализации, позволяя специалистам по телематике без труда анализировать и интерпретировать сложные данные телематики. Давайте рассмотрим основные элементы демонстрационного дашборда, предлагаемого Navixy, которые выделены синим цветом.
### Устройства и датчики для анализа
Для начала на демонстрационном дашборде выберите нужное устройство с помощью **Трекер** селектор. После выбора вы сможете создать несколько линейных графиков на одном холсте, выбрав нужные датчики в появившихся селекторах. Выберите в **Сырые данные 1** / **Сырые данные 2** выпадающих меню, если вы хотите анализировать сырые данные датчиков.
### Временной диапазон
В правом верхнем углу вы найдете возможность выбрать диапазон дат для анализа. Это дает вам гибкость при выборе между быстрыми диапазонами, которые предоставляют предопределенные интервалы времени, и абсолютным временным диапазоном, где вы можете указать конкретные даты начала и окончания.
### Линейные графики
Grafana предлагает широкий набор мощных вариантов визуализации, и среди них особенно выделяется линейный график. Этот график позволяет проводить всесторонний анализ показаний датчиков во времени, что оказывается незаменимым для специалистов по телематике. Нанося на линейный график такие данные телематики, как уровень топлива, скорость движения транспортного средства и т. д., пользователи получают возможность выявлять закономерности, тенденции и аномалии, которые могут влиять на работу автопарка. Интерактивные функции, такие как масштабирование и панорамирование, позволяют специалистам погружаться в конкретные периоды времени и получать более глубокое представление о данных.
### Таблицы
Таблицы на дашборде обеспечивают структурированный и удобный для пользователя формат исследования сырых данных датчиков. Каждое значение сопровождается временной меткой, что позволяет пользователям легко отслеживать, когда были сгенерированы данные. Такое упорядоченное представление облегчает всесторонний анализ отдельных точек данных, обеспечивая детальное изучение и получение выводов. На демонстрационном дашборде Navixy есть 2 таблицы: сырые данные датчиков по временным меткам и завершенные поездки с деталями.
### Карта
Отображения карты Grafana позволяют отслеживать объекты и события на карте, предоставляя ценные сведения о местоположении транспортных средств и поездках в выбранном временном диапазоне. Эта мощная функция обеспечивает всестороннюю визуализацию предыдущих перемещений транспортных средств, позволяя пользователям анализировать исторические данные и глубже понимать работу автопарка. Дополняя визуальное представление, сопровождающая таблица показывает точные показатели, такие как длина поездки и средняя скорость, что повышает общую эффективность анализа.
## Результат и дальнейшие шаги
Интеграция Grafana и API 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
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/ru/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.