Логи облачного балансировщика нагрузки

Логи облачного балансировщика нагрузки

к сведению

Логирование доступно только для балансировщиков нагрузки в пуле ru-8.

Для логирования балансировщика нагрузки используется сервис Платформа логов. Подробнее о принципе работы и стоимости сервиса в инструкции Общая информация о сервисе Платформа логов.

Для балансировщика нагрузки логируются следующие типы событий:

• HTTP-запрос;
• TCP-соединение;
• административное событие — изменение статуса сервера в целевой группе.

В зависимости от типа события для него записывается разный набор полей.

Чтобы собирать логи балансировщика нагрузки, нужно включить логирование для балансировщика. Получить логи можно только через API. Если вам больше не нужно собирать логи, вы можете выключить логирование.

Включить логирование для балансировщика нагрузки⁠

Вы можете включить логирование через API или в панели управления — при создании балансировщика нагрузки или для существующего балансировщика.

Включить логирование для существующего балансировщика нагрузки⁠

Логирование использует часть вычислительных ресурсов балансировщика.

Панель управления

1. В панели управления в верхнем меню нажмите Продукты и выберите Облачные серверы.
2. Перейдите в раздел Балансировщики → вкладка Балансировщики.
3. Откройте страницу балансировщика.
4. В блоке Настройки в поле Логирование нажмите .
5. Отметьте чекбокс Собирать технические логи балансировщика.
6. Выберите группу логов или создайте новую группу. В одну группу можно записывать логи одного или нескольких балансировщиков.
7. Если вы выбрали новую группу, введите ее имя.
8. Нажмите Сохранить.

OpenStack API

1. Получите IAM-токен для проекта, в котором создан балансировщик.

2. В выводе запроса скопируйте значение X-Subject-Token.

3. Откройте CLI.

4. Включите логирование для балансировщика:

   curl --location --request PUT 'https://<pool>.cloud.api.selcloud.ru/load-balancer/v2/lbaas/loadbalancers/<loadbalancer_uuid>/log_offloading' \
     --header 'X-Auth-Token: <x_auth_token>' \
     --header 'Content-Type: application/json;charset=utf-8' \
     --data '{
         "log_group": "<log_group_name>"
     }

   Укажите:

   • <pool> — пул, в котором создан балансировщик, например ru-8. Адрес (URL) зависит от региона и пула, можно посмотреть в списке URL;
   • <loadbalancer_uuid> — ID балансировщика. Посмотреть ID можно в панели управления: в верхнем меню нажмите Продукты → Облачные серверы → Балансировщики → страница балансировщика → под именем балансировщика нажмите ;
   • <x_auth_token> — IAM-токен для проекта, который вы скопировали на шаге 2;
   • <log_group_name> — имя группы логов, куда будут записываться логи балансировщика. Подробнее о группах логов в подразделе Принцип работы инструкции Общая информация о сервисе Платформа логов.

Выключить логирование для балансировщика нагрузки⁠

Панель управления

1. В панели управления в верхнем меню нажмите Продукты и выберите Облачные серверы.
2. Перейдите в раздел Балансировщики → вкладка Балансировщики.
3. Откройте страницу балансировщика.
4. В блоке Настройки в поле Логирование нажмите .
5. Снимите чекбокс Собирать технические логи балансировщика.
6. Нажмите Сохранить.

OpenStack API

1. Получите IAM-токен для проекта (X-Auth-Token).

2. В выводе запроса скопируйте значение X-Subject-Token.

3. Откройте CLI.

4. Выключите логирование для балансировщика:

   curl --location --request DELETE 'https://<pool>.cloud.api.selcloud.ru/load-balancer/v2/lbaas/loadbalancers/<loadbalancer_uuid>/log_offloading' \
     --header 'X-Auth-Token: <x_auth_token>' \
     --header 'Content-Type: application/json;charset=utf-8'

   Укажите:

   • <pool> — пул, в котором находится балансировщик, например ru-8. Адрес (URL) зависит от региона и пула, можно посмотреть в списке URL;
   • <loadbalancer_uuid> — ID балансировщика. Посмотреть ID можно в панели управления: в верхнем меню нажмите Продукты → Облачные серверы → Балансировщики → страница балансировщика → под именем балансировщика нажмите ;
   • <x_auth_token> — IAM-токен для проекта, который вы скопировали на шаге 2.

Получить логи⁠

Используйте инструкцию Получить логи в разделе Платформа логов.

Посмотрите описание полей логов для балансировщика нагрузки.

Поля логов⁠

В зависимости от типа события в логе отображается разный набор полей.

HTTP-запрос

loadbalancer_id	ID балансировщика
elapsed	Продолжительность обработки запроса
url	URL запроса
version	Версия HTTP-протокола
method	HTTP-метод запроса к балансировщику
status	Статус ответа на HTTP-запрос
bytest_in	Количество байт, переданных при запросе
bytes_out	Количество байт, переданных в ответе на запрос
backend	ID целевой группы балансировщика
client	IP-адрес и порт, с которого пришел запрос
frontend	ID правила балансировщика
server	ID сервера в целевой группе балансировщика
termination_state	Cостояние сессии при завершении, подробнее в разделе Session state at disconnection документации HAProxy
frontend_connections	Количество открытых соединений на правиле балансировщика
backend_connections	Количество открытых соединений на целевой группе балансировщика
server_connections	Количество открытых соединений на сервере, куда поступил запрос
retries	Количество повторных отправок запроса на сервер
destination	IP-адрес сервера, куда поступил запрос
backend_queue	Количество запросов на целевой группе балансировщика, ожидающих выполнения
server_queue	Количество запросов на сервере, ожидающих выполнения

TCP-соединение

loadbalancer_id
elapsed	Продолжительность обработки запроса
bytest_in	Количество байт, переданных при запросе
bytes_out	Количество байт, переданных в ответе на запрос
backend	ID целевой группы балансировщика
client	IP-адрес и порт клиента
frontend	ID правила балансировщика
server	ID сервера в целевой группе балансировщика
termination_state	Cостояние сессии при завершении, подробнее в разделе Session state at disconnection документации HAProxy
frontend_connections	Количество открытых соединений на правиле балансировщика
backend_connections	Количество открытых соединений на целевой группе балансировщика
server_connections	Количество открытых соединений на сервере, куда поступил запрос
destination	IP-адрес сервера, куда поступил запрос
backend_queue	Количество запросов на целевой группе, ожидающих выполнения
server_queue	Количество запросов на сервере, ожидающих выполнения

Административное событие

Административное событие — изменение статуса сервера в целевой группе.

listener_id	ID правила балансировщика
loadbalancer_id	ID балансировщика
status	Новый статус сервера в целевой группе
pool_id	ID целевой группы
member_id	ID сервера в целевой группе