Связаться с намиПодключиться

Создать триггер, который передает сообщения в функцию Cloud Functions из топика брокера Yandex IoT Core

Статья создана
Улучшена
Обновлена 21 апреля 2025 г.

Создайте триггер для топика брокера Yandex IoT Core и обрабатывайте копии сообщений с помощью функции Cloud Functions.

Важно

Триггер должен находиться в одном облаке с брокером, из топика которого он читает сообщения.

Перед началом работы

Для создания триггера вам понадобятся:

  • Брокер, из топика которого триггер будет принимать копии сообщений. Если у вас нет брокера, создайте его.

Создать триггер

Примечание

Триггер начинает работать в течение 5 минут после создания.

  1. В консоли управления перейдите в каталог, в котором хотите создать триггер.

  2. Выберите сервис Cloud Functions.

  3. На панели слева выберите Триггеры.

  4. Нажмите кнопку Создать триггер.

  5. В блоке Базовые параметры:

    • Введите имя и описание триггера.
    • В поле Тип выберите IoT Core (брокер).
    • В поле Запускаемый ресурс выберите Функция.

  6. В блоке Настройки сообщений IoT Core:

    • В поле Брокер укажите брокер.
    • (Опционально) В поле MQTT-топик укажите MQTT-топик. Если MQTT-топик не указан, тригер срабатывает для всех топиков брокера.

  7. В блоке Настройки группирования сообщений укажите:

    • Время ожидания, с. Допустимые значения от 1 до 60 секунд, значение по умолчанию — 1 секунда.
    • Размер группы. Допустимые значения от 1 до 100, значение по умолчанию — 1.

    Триггер группирует сообщения не дольше указанного времени ожидания и отправляет их в функцию. Число сообщений при этом не превышает указанный размер группы.

  8. В блоке Настройки функции выберите функцию и укажите:

  9. (Опционально) В блоке Настройки повторных запросов:

    • В поле Интервал укажите время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
    • В поле Количество попыток укажите количество повторных вызовов функции, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5, значение по умолчанию — 1.

  10. (Опционально) В блоке Настройки Dead Letter Queue выберите очередь Dead Letter Queue и сервисный аккаунт с правами на запись в нее.

  11. Нажмите кнопку Создать триггер.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

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

yc serverless trigger create iot-broker \
  --name <имя_триггера> \
  --broker-id <идентификатор_брокера> \
  --mqtt-topic '<MQTT-топик>' \
  --batch-size <размер_группы_сообщений> \
  --batch-cutoff <максимальное_время_ожидания> \
  --invoke-function-id <идентификатор_функции> \
  --invoke-function-service-account-id <идентификатор_сервисного_аккаунта> \
  --retry-attempts <количество_повторных_вызовов> \
  --retry-interval <интервал_между_повторными_вызовами> \
  --dlq-queue-id <идентификатор_очереди_Dead_Letter_Queue> \
  --dlq-service-account-id <идентификатор_сервисного_аккаунта>

Где:

  • --name — имя триггера.
  • --broker-id — идентификатор брокера.
  • --mqtt-topic — MQTT-топик, для которого вы хотите создать триггер. Необязательный параметр. Если параметр не указан, триггер срабатывает для всех топиков брокера.
  • --batch-size — размер группы сообщений из MQTT-топиков. Необязательный параметр. Допустимые значения от 1 до 10, значение по умолчанию — 1.
  • --batch-cutoff — максимальное время ожидания. Необязательный параметр. Допустимые значения от 1 до 60 секунд, значение по умолчанию — 1 секунда. Триггер группирует сообщения не дольше batch-cutoff и отправляет их в функцию. Число сообщений при этом не превышает batch-size.
  • --invoke-function-id — идентификатор функции.
  • --invoke-function-service-account-id — идентификатор сервисного аккаунта с правами на вызов функции.
  • --retry-attempts — количество повторных вызовов, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Необязательный параметр. Допустимые значения — от 1 до 5, значение по умолчанию — 1.
  • --retry-interval — время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Необязательный параметр. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
  • --dlq-queue-id — идентификатор очереди Dead Letter Queue. Необязательный параметр.
  • --dlq-service-account-id — идентификатор сервисного аккаунта с правами на запись в очередь Dead Letter Queue. Необязательный параметр.

Результат:

id: a1sl0mkmimfj********
folder_id: b1g88tflru0e********
created_at: "2019-09-25T13:54:35.654935Z"
name: iot-broker-trigger
rule:
  iot_broker_message:
    broker_id: arenou2oj4**********
    mqtt_topic: topic-for-broker
    batch_settings:
      size: "1"
      cutoff: 0s
    invoke_function:
      function_id: d4eofc7n0m03********
      function_tag: $latest
      service_account_id: aje3932acd0c********
      retry_settings:
        retry_attempts: "1"
        interval: 10s
status: ACTIVE

Чтобы создать триггер для Yandex IoT Core, воспользуйтесь методом REST API create для ресурса Trigger или вызовом gRPC API TriggerService/Create.

Проверить результат

Проверьте, что триггер работает корректно. Для этого посмотрите логи функции, в них отображается информация о вызовах.

См. также

Предыдущая
Устройство
Следующая
Создать триггер для бюджетов