Руководство по быстрому запуску

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

Требования

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

• Аккаунт Владелец роль в вашей учетной записи Navixy

• Активированные устройства в вашей учетной записи

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

Рабочая область IoT Logic доступна только для учетной записи Владельцы и не отображается для обычных Пользователей. Для подробностей о ролях пользователей см. Пользователи и роли.

Конфигурация потока

Просмотрите короткое видео, демонстрирующее процесс создания нового потока с вычислениями атрибутов данных и добавлением пользовательских атрибутов к устройствам на платформе:

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

Теперь давайте по шагам разберем процесс настройки потока.

1

Шаг 1: Доступ к рабочей области IoT Logic

1. Войдите в вашу учетную запись Navixy

2. Нажмите на значок профиля в верхнем левом углу экрана, чтобы перейти в Настройки аккаунта

3. Выберите IoT Logic в боковой панели настроек

Рабочая область IoT Logic содержит три основных секции:

• Панель настроек потока - Содержит элементы управления для управления потоками

• Панель узлов - Перечисляет доступные узлы для построения вашего потока

• Холст - Основное рабочее пространство, где вы проектируете поток

Для подробностей о рабочей области см. Рабочее пространство и поток по умолчанию.

2

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

1. Нажмите New flow кнопка на панели настроек потока

2. В New flow диалоговом окне:

• Введите описательное имя для вашего потока (например, «Fleet Telemetry Processing»)

• Добавьте краткое описание, объясняющее назначение потока

• Убедитесь, что переключатель Flow enabled переключатель включен

1. Нажмите Сохранить чтобы создать поток

Для дополнительной информации о настройке потока см. Управление потоками -> Создание нового потока.

Отключенные потоки не обрабатывают данные. Когда поток отключен, устройства в этом потоке не будут передавать данные ни в какие назначения, включая платформу Navixy.

3

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

1. Из Панели узлов панели перетащите Источник данных узел на холст

2. Наведите курсор на узел, чтобы отобразить быстрые действия, или дважды щелкните узел, чтобы открыть панель его конфигурации

3. Настройте следующие параметры:

• Имя узла - Введите описательное имя, указывающее происхождение отправляемых данных (например, Служебные автомобили)

• Источники - Выберите устройства, показания которых вы хотите отправлять в этот поток. Вы можете отфильтровать доступные устройства по данным Производитель и модели Модель.

1. Нажмите Сохранить для применения конфигурации

Для подробностей о конфигурации узла см. Узел Data Source.

4

Шаг 4: Добавьте обогащение данных (необязательно)

1. Перетащите ещё один Initiate Attribute узел на холст

2. Наведите курсор на узел, чтобы отобразить быстрые действия, или дважды щелкните узел, чтобы открыть панель его конфигурации

3. Добавьте описательный Имя узла чтобы указать его назначение и выполняемые вычисления (например, Температура °F в °C)

4. Определите ваш атрибут:

   1. Имя атрибута - Четкое, описательное имя (например, «speed_mph»)

   2. Formula - Выражение вычисления (например, value('speed')/1.609 для преобразования км/ч в миль/ч) 💡Примечание: Имена атрибутов могут заполняться автоматически чтобы обеспечить корректное именование. Автозаполнение по умолчанию использует короткий синтаксис, который обращается к последнему значению атрибута.

   3. Время генерации - Когда запись данных была создана на устройстве (по умолчанию now())

   4. Серверное время - Когда данные были получены сервером (по умолчанию now())

5. Добавьте дополнительные атрибуты при необходимости, нажав Add attribute 💡Примечание: Кнопка Сбросить форму откидывает все созданные атрибуты внутри узла. Если вы хотите удалить определенный атрибут, нажмите три точки справа от строки атрибута и выберите Delete.

6. Нажмите Сохранить для применения конфигурации

7. Создать соединение:

   1. Нажмите выходной разъем у Источник данных узлу

   2. Перетащите переход к входному разъему у Initiate Attribute узлу

Для подробностей о конфигурации узла см. Узел Initiate Attribute.

Для подробностей о действиях с атрибутами см. Управление атрибутами.

Для примеров формул вычислений см. Примеры вычислений.

5

Шаг 5: Настройте вывод данных

1. Перетащите ещё один Выходной конечной точке узел на холст

2. Наведите курсор на узел, чтобы отобразить быстрые действия, или дважды щелкните узел, чтобы открыть панель его конфигурации

3. Выберите Тип конечной точки:

• Конечная точка Navixy - стандартная конечная точка для отправки обработанных данных на платформу Navixy. Она предварительно настроена и не допускает изменений

• MQTT endpoint - конечная точка для отправки данных в сторонние назначения с использованием MQTT в качестве транспортного протокола. Требует ручной настройки, описанной в последующих шагах

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

1. Настройте следующие параметры:

   1. Имя конечной точки - Введите описательное имя, чтобы указать назначение, куда отправляются данные

   2. Протокол - Выберите протокол передачи данных (в настоящее время доступен только «Navixy Generic Protocol (JSON)»)

   3. IP/Домен - Введите адрес назначения

   4. Порт - Укажите номер порта (по умолчанию: 1883 для стандартного MQTT, 8883 для SSL)

   5. (необязательно) Включить SSL - Переключите ВКЛ для защищенных соединений

   6. Версия MQTT - Выберите соответствующую версию (3.1.1 или 5.0)

   7. Идентификатор клиента - Введите идентификатор для вашего клиента, чтобы обеспечить принятие данных принимающей стороной

   8. (необязательно) Темы - Укажите MQTT-темы для передачи данных

   9. QoS - Выберите уровень качества обслуживания, чтобы определить логику передачи данных (0, 1, или 2)

2. Если на стороне получателя требуется аутентификация, включите Аутентификация MQTT ВКЛ Появившиеся поля заполняются автоматически учетными данными вашей платформенной учетной записи

Узел Сбросить форму откидывает все созданные атрибуты внутри узла. Если вы хотите удалить определенный атрибут, нажмите три точки справа от строки атрибута и выберите Delete.

1. Нажмите Создавать для применения конфигурации

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

Каждый поток должен включать Default Endpoint узел, чтобы обеспечить отправку данных на платформу. Без этого подключения данные устройств не будут видны в интерфейсе Navixy.

Для подробностей о конфигурации узла см. Узел Output Endpoint.

6

Шаг 6: Сохраните и активируйте ваш поток

1. Проверьте, что все узлы в вашем потоке правильно подключены

2. Нажмите Сохранить поток кнопка в Панели узлов панели

Ваш поток теперь активен и обрабатывает данные в режиме реального времени!

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

Чтобы подтвердить правильную работу потока, используйте Data Stream Analyzer инструмент:

1. Нажмите Анализатор данных кнопка на панели настроек потока

2. Выберите устройства, которые вы хотите контролировать, из выпадающего списка

3. Наблюдайте входящие атрибуты данных и их значения

4. Используйте параметры фильтрации, чтобы сосредоточиться на конкретных параметрах

5. Убедитесь, что любые вычисленные атрибуты показывают корректные значения

Для подробностей по использованию инструмента см. Data Stream Analyzer.

Поздравляем! Ваш первый поток данных IoT Logic запущен и работает.

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

Теперь, когда вы создали ваш первый поток IoT Logic, вы можете:

• Адаптировать этот пример быстрого старта под ваши бизнес-потребности

• Создавать более сложные преобразования данных с несколькими Инициировать узлы Атрибутов

• Настроить дополнительные пункты назначения вывода для ваших данных, которые могут стать переиспользуемыми профилями для согласованных конфигураций

• Управлять уже созданными потоками чтобы настраивать обработку данных в соответствии с любыми изменениями, с которыми вы сталкиваетесь

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

Адаптация этого примера

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

• Выбор устройств: Выберите устройства, релевантные для ваших конкретных активов

• Преобразования единиц: Отрегулируйте формулы в соответствии с вашими стандартными единицами измерения

• Вычисляемые метрики: Создавайте отраслевые показатели, основанные на потребностях вашего бизнеса

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

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

Доступ через API

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

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

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

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

Что происходит с устройствами, не назначенными в пользовательский поток?

Устройства, явно не назначенные ни в какой пользовательский поток, автоматически обрабатываются потоком по умолчанию, который отправляет их данные напрямую на платформу Navixy.

Могу ли я использовать одно и то же устройство в нескольких потоках?

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

Будет ли мой поток продолжать работать, если я выйду из системы?

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

Как узнать, правильно ли работает мой поток?

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

Что произойдет, если я отключу поток?

Когда вы отключаете поток, устройства, назначенные этому потоку, не будут передавать данные ни в какие назначения, включая платформу Navixy. Устройства будут отображаться как офлайн в интерфейсе Navixy до тех пор, пока вы не включите поток снова.