> 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 позволяет отслеживать объекты и события на карте, предоставляя ценную информацию о местоположениях транспортных средств и поездках в выбранном временном диапазоне. Эта мощная функция обеспечивает всестороннюю визуализацию прежних перемещений транспортных средств, позволяя пользователям анализировать исторические данные и глубже понимать работу автопарка. В дополнение к визуальному представлению сопутствующая таблица показывает точные показатели, такие как длина поездки и средняя скорость, улучшая общий анализ.
## Результат и дальнейшие шаги
Интеграция 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
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/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 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.