Анализ данных по топливу с Grafana через интеграцию Navixy API

Введение

Иногда нашим партнёрам и интеграторам требуется более глубокий анализ необработанных данных о топливе и связанных параметров. Такой анализ может включать исследование уровня топлива, скорости, напряжения или состояния зажигания за определённые периоды времени и в заданных зонах на карте для выявления аномальных событий. Он также может дать представление о конфигурации датчиков, помочь диагностировать проблемы и контролировать работу в реальном времени. В этой статье мы рассмотрим, как интегрировать Grafana и Navixy API для удобного извлечения и визуализации данных контроля топлива.

Grafana — это инструмент визуализации данных с открытым исходным кодом, предлагающий широкий набор настраиваемых вариантов отображения. Его можно легко установить и настроить даже на вашем ПК или ноутбуке. Процесс установки обычно занимает около 30 минут.

Подключение Navixy к Grafana

Следуя этому пошаговому руководству, вы сможете бесшовно интегрировать Navixy с Grafana, что позволит эффективно визуализировать и анализировать ваши телематические данные.

Шаг 1: Получение API-ключа Navixy

Начните с входа в вашу учётную запись Navixy и перейдите в настройки аккаунта. Внутри настроек найдите раздел с API-ключами и создайте уникальный API-ключ. Этот ключ, например "8f6a4353bc5114d97e2068b4e398", будет использоваться для аутентификации соединения между Navixy и Grafana.

Шаг 2: Запуск Grafana

Grafana предоставляет 2 типа доступа: облачный или развёрнутый. Облачный доступ можно получить на их официальном сайте https://grafana.com/. Ниже мы рассмотрим, как установить пакет на собственный сервер или локальный компьютер.

Чтобы развернуть 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. Используйте учетные данные по умолчанию: "admin" как имя пользователя и пароль.

5. После входа вы можете сразу приступать к созданию и настройке дашбордов, используя различные источники данных для визуализации и анализа ваших данных.

Для установок на Linux/Mac или если вы предпочитаете использовать версию Grafana в Docker, обратитесь к официальной документации Grafana для получения подробных инструкций, соответствующих вашей конфигурации.

Шаг 3: Установка плагина источника данных JSON API

После запуска Grafana перейдите в меню «Connections» или «Plugins» в интерфейсе Grafana. Найдите плагин источника данных «JSON API» и выберите его. Установите плагин, следуя предоставленным инструкциям. Этот плагин необходим для установления связи между Grafana и Navixy API.

Шаг 4: Настройка соединения источника данных JSON API

После установки плагина «JSON API» ваш экземпляр Grafana готов подключиться к Navixy API с использованием API-ключа.

Выполните следующие шаги для настройки соединения:

1. Перейдите в меню «Connections» на левой панели

2. Найдите «JSON API» и выберите этот источник

3. Нажмите «Create a JSON API data source»

4. Заполните следующие поля:

• Name: Выберите предпочитаемое имя для источника данных

• URL: Введите URL для Navixy API. В зависимости от расположения вашей платформы используйте один из следующих URL:

  • https://api.eu.navixy.com/v2/ для Европы

  • https://api.us.navixy.com/v2/ для Северной Америки

  • <your_configured_domain_api_url> для установок с самостоятельным размещением (On-Premise). Формат по умолчанию обычно http(s)://your_configured_domain/api/

• Query string: Используйте строку запроса в формате hash=[YOUR_API_KEY]&iso_datetime=true. Например: hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true.

1. Настройте любые дополнительные параметры по необходимости, затем нажмите «Save & Test», чтобы проверить соединение.

Grafana и Navixy API — выбор источника данных

Grafana и Navixy API — настройка источника данных

Шаг 5: Импорт шаблона дашборда Navixy

Чтобы ускорить процесс настройки, импортируйте шаблон дашборда Navixy в Grafana. Зайдите в раздел управления дашбордами Grafana, создайте новый дашборд и выберите опцию импорта. Загрузите предоставленный файл шаблона дашборда Navixy. Проверьте настройки импорта, включая назначенный источник данных, и завершите процесс импорта.

Анализ телематических данных с помощью Grafana

Grafana предоставляет полный набор объектов визуализации и инструментов, позволяющих специалистам по телематике легко анализировать и интерпретировать сложные телематические данные. Рассмотрим основные элементы демонстрационного дашборда, предлагаемого Navixy, которые отмечены синим цветом.

Трекеры и датчики для анализа

Для начала на демонстрационном дашборде выберите нужное устройство с помощью селектора «Tracker». После выбора вы можете создать несколько линейных графиков на одном холсте, выбрав нужные датчики в селекторах «Sensor 1» и «Sensor 2». Выберите «True» в выпадающих меню «Raw Data 1» / «Raw data 2», если вы хотите анализировать необработанные данные датчиков.

Диапазон времени

В правом верхнем углу находится опция выбора диапазона дат для вашего анализа. Это даёт гибкость при выборе между быстрыми диапазонами, которые предоставляют предопределённые интервалы времени, или абсолютным диапазоном времени, где вы можете указать конкретные дату и время начала и окончания.

Линейные графики

Grafana предлагает ряд мощных вариантов визуализации, и среди них выделяются линейные графики. Этот график позволяет всесторонне анализировать показания датчиков во времени, что чрезвычайно важно для специалистов по телематике. Нанесение телематических данных, таких как уровень топлива, скорость автомобиля и т. п., на линейный график даёт возможность выявлять закономерности, тренды и аномалии, которые могут влиять на работу автопарка. Интерактивные функции, такие как масштабирование и панорамирование, позволяют специалистам углубляться в конкретные периоды времени и извлекать более глубокие выводы из данных.

Таблицы

Таблицы на дашборде предоставляют структурированный и удобный формат для изучения необработанных данных датчиков. Каждое значение сопровождается временной меткой, что позволяет пользователям легко отслеживать момент генерации данных. Такая организованная подача облегчает всесторонний анализ отдельных точек данных и получение детальных выводов. Демонстрационный дашборд Navixy содержит 2 таблицы: необработанные данные датчиков по временным меткам и завершённые треки с деталями.

Просмотр на карте

Карты Grafana облегчают мониторинг объектов и событий на карте, предоставляя ценные сведения о местоположении транспортных средств и поездках в выбранном временном диапазоне. Эта мощная функция обеспечивает всестороннюю визуализацию предыдущих перемещений транспортных средств, позволяя пользователям анализировать исторические данные и глубже понимать работу автопарка. В дополнение к визуальному представлению сопутствующая таблица отображает точные метрики, такие как длина поездки и средняя скорость, что улучшает общий анализ.

Итоги и дальнейшие шаги

Интеграция Grafana и Navixy API представляет собой мощное решение для визуализации и анализа телематических данных, связанных с контролем топлива. Используя возможности Grafana по визуализации данных с открытым исходным кодом и расширенный API Navixy, пользователи могут получить ценные инсайты о потреблении топлива автопарком, отслеживать аномальные события и эффективно устранять неполадки.

Настройка дашборда

Как интегратор, вы имеете гибкость в настройке элементов дашборда в соответствии с вашими конкретными требованиями. Grafana предоставляет различные объекты визуализации, которые можно настроить для доступа к полному набору телематических данных из Navixy API. Это включает выбор и настройку разнообразных визуализаций Grafana для анализа временных рядов и других типов данных, что позволяет исследовать данные более содержательно. Используя настраиваемые дашборды, пользователи могут создавать персонализированные визуализации, отвечающие их конкретным потребностям анализа. Это даёт возможность менеджерам автопарка и заинтересованным сторонам контролировать работу в реальном времени, диагностировать проблемы и принимать обоснованные решения на основе проанализированных данных. Настройка дашборда требует опыта работы с Navixy API и форматом JSON.

Обмен дашбордами Grafana

Совместное использование вашего настраиваемого дашборда с другими в Grafana — это простой процесс. Делая дашборды доступными для членов команды, клиентов или заинтересованных сторон, вы улучшаете сотрудничество и обмен знаниями. Для начала вы можете экспортировать дашборд в виде JSON-файла, который содержит всю необходимую информацию для воссоздания дашборда на другом экземпляре Grafana. Эта упрощённая функция обмена обеспечивает доступ всем вовлечённым лицам к инсайтам и анализу, которые предоставляет дашборд.