> 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 — это инструмент визуализации данных с открытым исходным кодом, который предлагает широкий спектр настраиваемых вариантов визуализации. Его можно легко установить и настроить даже на вашем ПК или ноутбуке. Процесс установки обычно занимает около 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. После входа вы можете сразу начать создавать и настраивать панели мониторинга, используя различные Источники данных для визуализации и анализа ваших данных.
Если вы устанавливаете Grafana на 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 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.