Подключиться
Yandex Cloud Functions

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

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

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

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

  1. Функция, которую триггер будет запускать. Если у вас еще нет функции:
  2. (опционально) Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогла обработать функция. Если у вас нет очереди, создайте ее.
  3. Сервисный аккаунт с правами на вызов функции и (опционально) запись в очередь Dead Letter Queue. Вы можете использовать один и тот же сервисный аккаунт или разные. Если у вас нет сервисного аккаунта, создайте его.

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

Примечание

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

  1. В консоли управления перейдите в каталог, в котором хотите создать триггер.
  2. Откройте сервис Cloud Functions.
  3. Перейдите на вкладку Триггеры.
  4. Нажмите кнопку Создать триггер.
  5. В блоке Базовые параметры:
    • Введите имя и описание триггера.
    • В поле Тип выберите Cloud Logs.
  6. В блоке Настройки Cloud Logs укажите, сообщения из каких источников будет обрабатывать функция. Лог-группы определятся автоматически.
  7. (опционально) В блоке Настройки группирования сообщений укажите:
    • размер группы сообщений. Допустимые значения от 1 до 10, значение по умолчанию — 1.
    • максимальное время ожидания. Допустимые значения от 0 до 20 секунд, значение по умолчанию — 10 секунд. Триггер отправит группу сообщений в функцию, когда число сообщений в лог-группе достигнет указанного размера группы или истечет максимальное время ожидания.
  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 cloud-logs \
    --name <имя триггера> \
    --log-groups <идентификаторы лог-групп через запятую> \
    --batch-size 10 \
    --batch-cutoff 10s \
    --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-groups — список идентификаторов лог-групп.
  • --batch-size — размер группы сообщений. Необязательный параметр. Допустимые значения от 1 до 10, значение по умолчанию — 1.
  • --batch-cutoff — максимальное время ожидания. Необязательный параметр. Допустимые значения от 0 до 20 секунд, значение по умолчанию — 10 секунд. Триггер отправит группу сообщений в функцию, когда число сообщений в лог-группе достигнет batch-size или истечет batch-cutoff.
  • --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: a1s92agr8mpgeo3kjt48
folder_id: b1g88tflru0ek1omtsu0
created_at: "2020-08-13T10:46:55.947Z"
name: log-trigger
rule:
  cloud_logs:
    log_group_id:
    - eolhui6rdfg564kl8h67
    - eol7tkttsd345gju74df
    batch_settings:
      size: "1"
      cutoff: 10s
    invoke_function:
      function_id: d4eofc7n0m03lmudsk7y
      function_tag: $latest
      service_account_id: aje3932acd0c5ur7drte
      retry_settings:
        retry_attempts: "1"
        interval: 10s
      dead_letter_queue:
        queue-id: yrn:yc:ymq:ru-central1:aoek49ghmknnpj1ll45e:dlq
        service-account-id: aje3932acd0c5ur7dagp
status: ACTIVE

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

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

Проверьте, что триггер работает корректно. Для этого посмотрите логи:

  • функции, которую вызывает триггер.
  • функций, которые указали как источники логов.

Посмотрите логи реестров и устройств, которые указали как источники логов.

Что дальше

В этой статье: