Создание триггера для Cloud Logs
Внимание
Триггер для Cloud Logs устарел. Используйте триггер для Cloud Logging.
Создайте триггер для Cloud Logs, который будет вызывать вашу функцию при поступлении сообщений в лог-группу.
Для создания триггера вам понадобятся:
-
Функция, которую триггер будет запускать. Если у вас еще нет функции:
-
(опционально) Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогла обработать функция. Если у вас нет очереди, создайте ее.
-
Сервисный аккаунт с правами на вызов функции и (опционально) запись в очередь Dead Letter Queue. Вы можете использовать один и тот же сервисный аккаунт или разные. Если у вас нет сервисного аккаунта, создайте его.
Создать триггер
Примечание
Триггер начинает работать в течение 5 минут после создания.
-
В консоли управления перейдите в каталог, в котором хотите создать триггер.
-
Откройте сервис Cloud Functions.
-
На панели слева выберите Триггеры.
-
Нажмите кнопку Создать триггер.
-
В блоке Базовые параметры:
- Введите имя и описание триггера.
- В поле Тип выберите Cloud Logs.
-
В блоке Настройки Cloud Logs укажите, сообщения из каких источников будет обрабатывать функция. Лог-группы определятся автоматически.
-
(опционально) В блоке Настройки группирования сообщений укажите:
- размер группы сообщений. Допустимые значения от 1 до 10, значение по умолчанию — 1.
- максимальное время ожидания. Допустимые значения от 0 до 20 секунд, значение по умолчанию — 10 секунд. Триггер отправит группу сообщений в функцию, когда число сообщений в лог-группе достигнет указанного размера группы или истечет максимальное время ожидания.
-
В блоке Настройки функции:
-
Выберите функцию, которую будет вызывать триггер.
Внимание
Выбор функции, которая служит источником логов для триггера, может привести к экспоненциальному росту вызовов.
-
Укажите тег версии функции.
-
Укажите сервисный аккаунт, от имени которого будет вызываться функция.
-
-
(опционально) В блоке Настройки повторных запросов:
- В поле Интервал укажите время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.
- В поле Количество попыток укажите количество повторных вызовов функции, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5, значение по умолчанию — 1.
-
(опционально) В блоке Настройки Dead Letter Queue выберите очередь Dead Letter Queue и сервисный аккаунт с правами на запись в нее.
-
Нажмите кнопку Создать триггер.
Если у вас еще нет интерфейса командной строки 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.
Проверить результат
Проверьте, что триггер работает корректно. Для этого посмотрите логи:
- функции, которую вызывает триггер.
- функций, которые указали как источники логов.
Посмотрите логи реестров и устройств, которые указали как источники логов.