Изменить лог-группу
- В консоли управления
перейдите в каталог, в котором находится лог-группа. - Выберите сервис Cloud Logging.
- В строке с лог-группой нажмите значок
. - В открывшемся меню нажмите кнопку Редактировать.
- Измените параметры лог-группы.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Для обращения к лог-группе используйте ее имя или уникальный идентификатор. Чтобы узнать их, получите список лог-групп в каталоге.
Чтобы изменить параметры лог-группы, например срок хранения записей, выполните команду:
yc logging group update --name=default --retention-period=24h
Где:
-
--name
— имя лог-группы, срок хранения записей в которой вы хотите изменить. -
--retention-period
— новый срок хранения записей в лог-группе.Срок хранения записей можно указать только в часах, минутах или секундах. Например,
1h
или1440m
.
Результат:
id: af3mu6hnd0**********
folder_id: aoek6qrs8t**********
cloud_id: aoegtvhtp8**********
created_at: "2023-06-22T09:51:43.614Z"
name: default
status: ACTIVE
retention_period: 86400s
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы изменить параметры лог-группы, созданной с помощью Terraform:
-
Откройте файл конфигурации Terraform и измените нужный параметр в описании лог-группы, например срок хранения записей:
... resource "yandex_logging_group" "group1" { name = "test-logging-group" folder_id = "<идентификатор_каталога>" retention_period = "5h" } ...
Где:
-
name
— имя лог-группы. Необязательный параметр. -
folder_id
— идентификатор каталога. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера. -
retention_period
— новый срок хранения записей в лог-группе.Срок хранения записей можно указать только в часах, минутах или секундах. Например,
1h
или1440m
.
Более подробную информацию о параметрах ресурса
yandex_logging_group
в Terraform, см. в документации провайдера . -
-
Проверьте конфигурацию командой:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминал слово
yes
и нажмите Enter.Проверить изменение лог-группы можно в консоли управления
или с помощью команды CLI:yc logging group get <имя_лог-группы>
Чтобы изменить лог-группу, воспользуйтесь методом REST API update для ресурса LogGroup или вызовом gRPC API LogGroupService/Update.
Пример запроса
Пример использования написан с помощью утилиты grpcurl
. Чтобы воспользоваться им, аутентифицируйтесь в API и клонируйте репозиторий cloudapi
В примере обновляется срок хранения записей.
Создайте файл payload.json
:
{
"log_group_id": "<идентификатор_лог-группы>",
"retention_period": "24h",
"update_mask": {
"paths": ["retention_period"]
}
}
Выполните запрос:
grpcurl -rpc-header "Authorization: Bearer $(yc iam create-token)" \
-d @ \
-import-path ~/cloudapi/ \
-import-path ~/cloudapi/third_party/googleapis/ \
-proto ~/cloudapi/yandex/cloud/logging/v1/log_group_service.proto \
logging.api.cloud.yandex.net:443 yandex.cloud.logging.v1.LogGroupService.Update < payload.json
Ответ:
{
"id": "e23omac87b3a********",
"description": "Update log group",
"createdAt": "2023-03-25T05:39:24.058608338Z",
"createdBy": "ajego134p5h1********",
"modifiedAt": "2023-03-25T05:39:24.058608338Z",
"metadata": {
"@type": "type.googleapis.com/yandex.cloud.logging.v1.UpdateLogGroupMetadata",
"logGroupId": "e23ff0on5amv********"
}
}