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

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

Триггеры находятся на стадии Preview.

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

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

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

  1. Сервисный аккаунт с правами на вызов функции. Если у вас нет сервисного аккаунта, создайте его.
  2. Функция, которую триггер будет запускать. Если у вас еще нет функции:

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

Примечание

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

Чтобы создать триггер:

  1. Откройте раздел Cloud Functions в каталоге, где требуется создать триггер для Cloud Logs.
  2. Перейдите во вкладку Триггеры.
  3. Нажмите кнопку Создать триггер.
  4. В блоке Базовые параметры:
    • Введите имя и описание триггера.
    • В поле Тип выберите Cloud Logs.
  5. В блоке Настройки Cloud Logs:
    • В поле Источники логов выберите источники логов. Лог-группы будут определены автоматически.
    • В поле Время ожидания выберите максимальное время накопления группы сообщений.
    • В поле Размер группы сообщений выберите максимальный размер группы сообщений.
  6. В блоке Настройки повторных запросов:
    • В поле Интервал укажите 5 секунд.
    • В поле Количество попыток укажите 5.
  7. В блоке Настройки функции:

    • Выберите функцию, которую будет вызывать триггер.

      Внимание

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

    • Укажите тег версии функции.

    • Укажите сервисный аккаунт, от имени которого будет вызываться функция.

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

Триггер будет создан и отобразится в таблице в разделе Триггеры.

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

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

Создайте триггер:

  • --name — имя триггера.
  • --log-groups — список уникальных идентификаторов лог-групп.
  • --batch-size — максимальный размер группы сообщений.
  • --batch-cutoff — максимальное время накопления группы сообщений.
  • --invoke-function-id — уникальный идентификатор функции.
  • --invoke-function-service-account-id — сервисный аккаунт с правами на вызов функции.

Чтобы создать триггер для Cloud Logs, выполните команду:

$ yc serverless trigger create cloud-logs \
    --name <имя триггера> \
    --log-groups <список идентификаторов лог-группы через запятую> \
    --batch-size <максимальный размер группы сообщений> \
    --batch-cutoff <максимальное время накопления группы сообщений> \
    --invoke-function-id <идентификатор функции> \
    --invoke-function-service-account-id <идентификатор сервисного аккаунта>

Результат:

id: dd0c6gsr************
folder_id: aoeuooa5************
created_at: "2020-08-13T10:46:55.947Z"
name: log-trigger
rule:
  cloud_logs:
    log_group_id:
    - eolhui6r************
    - eol7tktt************
    batch_settings:
      size: "5"
      cutoff: 10s
    invoke_function:
      function_id: b091v4rl************
      function_tag: $latest
      service_account_id: bfbm2ib6************
      retry_settings:
        retry_attempts: "1"
        interval: 10s
status: ACTIVE
В этой статье: