Краткое руководство пользователя

Это руководство поможет вам быстро настроить первый поток данных в IoT Logic и начать обработку телематических данных.

Предварительные требования

Перед созданием первого потока убедитесь, что у вас есть:

• Роль Владельца в аккаунте ГМ Телематика

• Активированные устройства в аккаунте

• Понимание того, какие источники данных вы хотите обрабатывать

Настройка потока

Давайте разберём процесс настройки потока по шагам.

Шаг 1: Открытие IoT Logic

• Войдите в аккаунт ГдеМои

• Нажмите на иконку профиля в левом верхнем углу

• Перейдите в Настройки Аккаунта

• Выберите IoT Logic

Откроется рабочее пространство с тремя разделами:

• Поток данных— управление потоками

• Узлы — список узлов

• Рабочее пространство — область построения потока

Шаг 2: Создание нового потока

• Нажмите Новый поток

• Введите:

  • Название (например, “Обработка телеметрии”)

  • Описание

• Включите “Поток включен“

• Нажмите “Сохранить“

Шаг 3: Настройка Источника данных

• Перетащите Источник данных на холст

• Откройте настройки (наведение или двойной клик)

• Укажите:

  • Name — название Источника данных

  • Источники— устройства (можно фильтровать по производителю и модели)

• Нажмите “Сохранить“

Шаг 4: Узел вычисления атрибута (опционально)

• Добавьте узел Вычисление Атрибута

• Откройте настройки

Настройте:

• Name — название узла

• Attribute name — имя атрибута

• Formula — формула (например, value('speed')/1.609)

Можно добавлять несколько атрибутов.

• Нажмите “Применить”

Создайте связь:

• соедините Источник данных → Вычисление атрибута

Шаг 5: Настройка узла Передачи данных

• Добавьте узел Передачи данных

• Откройте настройки
  Настройте:

• Name — название узла

• Выберите тип:

Узел Передачи Данных по умолчанию — по умолчанию данные будут передаваться в нашу систему

MQTT endpoint — для сторонних систем

• MQTT Версия— 3.1.1 или 5.0

• IP/Domain — адрес

• Port — порт (1883 или 8883)

• Топики— (опционально)

• QoS — уровень доставки

• Client ID — идентификатор

• SSL — при необходимости

При необходимости включите MQTT Authentication.

Соедините все узлы с узлом Передачи данных.

Шаг 6: Сохранение и запуск

• Проверьте связи между узлами

• Нажмите Сохранить поток

Поток начнёт обрабатывать данные в реальном времени.

Проверка потока

Для проверки используйте Анализ данных:

• Нажмите Анализ данных

• Выберите устройства

• Наблюдайте данные и атрибуты

• Используйте фильтры

• Проверьте корректность вычислений

Подробнее: Анализ данных.

Следующие шаги

Теперь вы можете:

• адаптировать пример под бизнес-задачи

• создавать более сложные преобразования

• настраивать дополнительные точки вывода

• управлять потоками

• строить сложные сценарии

Адаптация примера

Этот пример можно адаптировать под различные отраслевые сценарии, изменяя:

• Выбор устройств: выбирайте устройства, соответствующие вашим активам

• Преобразование единиц измерения: корректируйте формулы в соответствии с используемыми единицами

• Рассчитываемые метрики: создавайте отраслевые показатели на основе ваших бизнес-задач

• Конфигурацию вывода: подключайте вашу платформу аналитики или базу данных

Базовый шаблон — сбор, преобразование и передача данных — остаётся одинаковым для всех отраслей, что делает его универсальным для обработки IoT-данных.

Доступ к API

Функциональность IoT Logic также доступна программно через API ГМ Телематика. Это позволяет разработчикам автоматизировать создание, управление и мониторинг потоков.

Для получения полной документации API, параметров, форматов запросов/ответов и примеров кода обратитесь к документации ГМ Телематика IoT Logic API.

Часто задаваемые вопросы

Что происходит с устройствами, не назначенными в Пользовательский поток?
Устройства, не назначенные ни в один Пользовательский поток, автоматически обрабатываются Default flow, который отправляет их данные напрямую в платформу ГМ Телематика.

Можно ли использовать одно устройство в нескольких потоках?
Нет, каждое устройство может быть назначено только одному потоку. При добавлении в Пользовательский поток оно автоматически удаляется из Default flow, чтобы избежать дублирования обработки данных.

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

Как понять, что поток работает корректно?
Используйте раздел Анализ данных для мониторинга данных в реальном времени. Инструмент показывает как исходные данные устройства, так и вычисленные атрибуты, позволяя проверить корректность обработки.

Что произойдёт, если отключить поток?
Если отключить поток, устройства, назначенные этому потоку, перестанут передавать данные в любые назначения, включая платформу ГМ Телематика. В интерфейсе ГМ Телематика они будут отображаться как офлайн до повторного включения потока.