Настроить запись логов L7-балансировщика

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

Yandex Cloud

Улучшена

mmerihsesh

Обновлена 21 апреля 2025 г.

Включить запись логов
Изменить параметры записи логов
Выключить запись логов

Логи L7-балансировщика можно отправлять в сервис Yandex Cloud Logging.

Включить запись логов

Консоль управления

CLI

Terraform

API

В консоли управления выберите каталог, в котором находится балансировщик.
Выберите сервис Application Load Balancer.
В списке выберите нужный балансировщик, нажмите и выберите Редактировать.
В блоке Настройки логов:
1. Включите опцию Запись логов.
2. Выберите лог-группу Cloud Logging, в которую будут записываться логи балансировщика.
3. Нажмите кнопку Добавить правило отбрасывания логов и настройте его параметры:
  - HTTP-коды — добавьте HTTP-коды.
  - Классы HTTP-кодов — добавьте классы HTTP-кодов.
  - gRPC-коды — добавьте gRPC-коды.
  - Доля отбрасываемых логов — добавьте процент отбрасываемых логов.
  Вы можете задать больше одного правила.
Нажмите Сохранить.

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

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

Посмотрите описание команды CLI для управления логированием в балансировщике:
```
yc alb load-balancer logging --help
```
Включите логирование и установите параметры записи логов в Cloud Logging:
```
yc alb load-balancer logging <имя_балансировщика> \
  --enable \
  --log-group-id <идентификатор_лог-группы> \
  --discard codes=[<HTTP-код>,<класс_HTTP-кода>,<gRPC-код>],percent=<доля_отбрасываемых_логов>
```
Где:
- --enable — параметр для включения логирования.
- --log-group-id — идентификатор лог-группы, в которую будут записываться логи балансировщика.
- --discard — правило отбрасывания логов. Параметры правила:
  - codes — HTTP-коды, классы HTTP-кодов или gRPC-коды.
  - percent — доля отбрасываемых логов в процентах.
  Вы можете задать больше одного правила.
Результат:
```
done (42s)
id: ds76g8b2op3f*********
name: test-load-balancer
...
log_options:
  log_group_id: e23p9bfj2kyr********
  discard_rules:
    - http_codes:
        - "200"
      http_code_intervals:
        - HTTP_2XX
      grpc_codes:
        - OK
      discard_percent: "70"
```

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Добавьте к описанию балансировщика в конфигурационном файле блок log_options:
```
log_options {
  log_group_id = "<идентификатор_лог-группы>"
  discard_rule {
    http_codes          = ["200"]
    http_code_intervals = ["HTTP_2XX"]
    grpc_codes          = ["GRPC_OK"]
    discard_percent     = 75
  }
}
```
Где log_options — параметры записи логов в Cloud Logging:
- log_group_id — идентификатор лог-группы, в которую будут записываться логи балансировщика.
- discard_rule — правило отбрасывания логов:
  - http_codes — HTTP-коды.
  - http_code_intervals — классы HTTP-кодов.
  - grpc_codes — gRPC-коды.
  - discard_percent — доля отбрасываемых логов в процентах.
  Вы можете задать больше одного правила.
Примените изменения:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого в указанном балансировщике будет включено логирование. Проверить статус логирования и другие настройки балансировщика можно в консоли управления или с помощью команды CLI:

yc alb load-balancer get <имя_балансировщика>

Чтобы включить запись логов, воспользуйтесь методом REST API update для ресурса LoadBalancer или вызовом gRPC API LoadBalancerService/Update.

Изменить параметры записи логов

Консоль управления

CLI

Terraform

API

В консоли управления выберите каталог, в котором находится балансировщик.
Выберите сервис Application Load Balancer.
В списке выберите нужный балансировщик, нажмите и выберите Редактировать.
В блоке Настройки логов:
1. Измените лог-группу Cloud Logging, в которую будут записываться логи балансировщика.
2. Измените правила отбрасывания логов:
  - HTTP-коды — измените HTTP-коды.
  - Классы HTTP-кодов — измените классы HTTP-кодов.
  - gRPC-коды — измените gRPC-коды.
  - Доля отбрасываемых логов — измените процент отбрасываемых логов.
  Чтобы добавить еще одно правило, нажмите кнопку Добавить правило отбрасывания логов.
Нажмите Сохранить.

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

Посмотрите описание команды CLI для управления логированием в балансировщике:
```
yc alb load-balancer logging --help
```
Измените параметры записи логов в Cloud Logging:
```
yc alb load-balancer logging <имя_балансировщика> \
  --log-group-id <идентификатор_лог-группы> \
  --discard codes=[<HTTP-код>,<класс_HTTP-кода>,<gRPC-код>],percent=<доля_отбрасываемых_логов>
```
Где:
- --log-group-id — идентификатор лог-группы, в которую будут записываться логи балансировщика.
- --discard — правило отбрасывания логов. Параметры правила:
  - codes — HTTP-коды, классы HTTP-кодов или gRPC-коды.
  - percent — доля отбрасываемых логов в процентах.
  Вы можете задать больше одного правила.
Результат:
```
done (42s)
id: ds76g8b2op3f********
name: test-load-balancer
...
log_options:
  log_group_id: e23p9bfj2kyr********
  discard_rules:
    - http_codes:
        - "200"
      http_code_intervals:
        - HTTP_2XX
      grpc_codes:
        - OK
      discard_percent: "70"
```

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

В конфигурационном файле с описанием балансировщика измените блок log_options с новыми настройками логирования:
```
log_options {
  log_group_id = "<идентификатор_лог-группы>"
  discard_rule {
    http_codes          = ["200"]
    http_code_intervals = ["HTTP_2XX"]
    grpc_codes          = ["GRPC_OK"]
    discard_percent     = 75
  }
}
```
Где log_options — параметры записи логов в Cloud Logging:
- log_group_id — идентификатор лог-группы, в которую будут записываться логи балансировщика.
- discard_rule — правило отбрасывания логов:
  - http_codes — HTTP-коды.
  - http_code_intervals — классы HTTP-кодов.
  - grpc_codes — gRPC-коды.
  - discard_percent — доля отбрасываемых логов в процентах.
  Вы можете задать больше одного правила.
Примените изменения:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого в указанном балансировщике будут изменены параметры логирования. Проверить настройки балансировщика можно в консоли управления или с помощью команды CLI:

yc alb load-balancer get <имя_балансировщика>

Чтобы изменить параметры записи логов, воспользуйтесь методом REST API update для ресурса LoadBalancer или вызовом gRPC API LoadBalancerService/Update.

Выключить запись логов

Консоль управления

CLI

Terraform

API

В консоли управления выберите каталог, в котором находится балансировщик.
Выберите сервис Application Load Balancer.
В списке выберите нужный балансировщик, нажмите и выберите Редактировать.
В блоке Настройки логов выключите опцию Запись логов.
Нажмите Сохранить.

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

Посмотрите описание команды CLI для управления логированием в балансировщике:
```
yc alb load-balancer logging --help
```

Выключите логирование:

yc alb load-balancer logging <имя_балансировщика> --disable

Где --disable — параметр для выключения логирования.

Результат:

done (42s)
id: ds76g8b2op3f********
name: test-load-balancer
...
log_options:
  disable: true

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

В конфигурационном файле с описанием балансировщика удалите блок log_options:
```
log_options {
...
}
```
Примените изменения:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.
После этого в указанном балансировщике будет выключено логирование. Проверить статус логирования и другие настройки балансировщика можно в консоли управления или с помощью команды CLI:
```
yc alb load-balancer get <имя_балансировщика>
```

Чтобы выключить запись логов, воспользуйтесь методом REST API update для ресурса LoadBalancer или вызовом gRPC API LoadBalancerService/Update.

Настроить запись логов L7-балансировщика

Включить запись логов

Изменить параметры записи логов

Выключить запись логов

Была ли статья полезна?