Изменить лог-группу

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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:

1. Откройте файл конфигурации 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, см. в документации провайдера.

2. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

3. Выполните команду:

   terraform plan
   

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

4. Примените изменения конфигурации:

   terraform apply
   

5. Подтвердите изменения: введите в терминал слово 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.yandexcloud.kz: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********"
  }
}