Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Cloud Functions

Создание триггера для Yandex Cloud Logging

Статья создана

Создайте триггер для Cloud Logging, который будет вызывать функцию Cloud Functions или контейнер Serverless Containers при добавлении записей в лог-группу.

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

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

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

Примечание

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

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

  2. Откройте сервис Cloud Functions.

  3. Перейдите на вкладку Триггеры.

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

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

    • Введите имя и описание триггера.
    • В поле Тип выберите Cloud Logging.
    • Выберите, что будет запускать триггер — функцию или контейнер.

  6. В блоке Настройки Cloud Logging укажите:

    • лог-группу;
    • (опционально) типы ресурсов — ваши сервисы или сервисы Yandex.Cloud, например serverless.function;
    • (опционально) идентификаторы ваших ресурсов или ресурсов Yandex.Cloud, например функций Cloud Functions;
    • (опционально) уровни логирования.

    Триггер срабатывает, когда в указанную лог-группу добавляют записи, которые соответствуют всем опциональным настройкам. Если опциональная настройка не задана, триггер срабатывает при любом ее значении.

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

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

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

  8. Если триггер будет запускать:

    • функцию, в блоке Настройки функции выберите ее и укажите:
    • контейнер, в блоке Настройки контейнера выберите его и укажите:

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

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

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

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

yc serverless trigger create logging \
    --name <имя триггера> \
    --log-group-name <имя лог-группы> \
    --batch-size 1 \
    --batch-cutoff 1s \
    --invoke-function-id <идентификатор функции> \
    --invoke-function-service-account-id <идентификатор сервисного аккаунта> \
    --retry-attempts 1 \
    --retry-interval 10s \
    --dlq-queue-id <идентификатор очереди Dead Letter Queue> \
    --dlq-service-account-id <идентификатор сервисного аккаунта>

Где:

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

Результат:

id: a1sfe084v4se4morbu2i
folder_id: b1g88tflru0ek1omtsu0
created_at: "2019-12-04T08:45:31.131391Z"
name: logging-trigger
rule:
  logging:
    log-group-name: default
    batch_settings:
      size: "1"
      cutoff: 1s
    invoke_function:
      function_id: d4eofc7n0m03********
      function_tag: $latest
      service_account_id: aje3932acd0c********
      retry_settings:
        retry_attempts: "1"
        interval: 10s
      dead_letter_queue:
        queue-id: yrn:yc:ymq:ru-central1:aoek49ghmknn********:dlq
        service-account-id: aje3932acd0c********
status: ACTIVE

Создать триггер можно с помощью метода API create.

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

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

Что дальше

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье: