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

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

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

Внимание

Триггер для Cloud Logs устарел. Используйте триггер для Cloud Logging.

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

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

  • Функция, которую триггер будет запускать. Если у вас еще нет функции:
  • (опционально) Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогла обработать функция. Если у вас нет очереди, создайте ее.
  • Сервисный аккаунт с правами на вызов функции и (опционально) запись в очередь 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.

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

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

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

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

Что дальше

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