Логгеры

Страница «Логгеры» в интерфейсе Axelix

Чтобы разобраться с проблемой на работающем сервисе, часто нужны более подробные логи из какой-то его части. Страница Логгеры позволяет сразу поднять уровень логгера, не меняя конфигурацию и не перезапуская сервис, а потом вернуть его обратно.

Страница доступна для всех пользователей, прошедших аутентификацию:VIEWER, EDITOR, ADMIN и SUPER_ADMIN могут открывать ее, изменять уровни доступа и сбрасывать их. Полную матрицу ролей и полномочий см. в разделе Роли и полномочия.

Что показывает страница

На странице перечислены все логгеры и группы логгеров сервиса с их текущим уровнем. Мишень у уровня означает, что уровень задан явно для этого логгера или группы, в конфигурации приложения или в Axelix. Уровень без мишени унаследован от родительского логгера.

Уровень можно изменить:

• У логгера. Его дочерние логгеры без собственного уровня наследуют новый уровень: если переключить com.axelixlabs.axelix с INFO на DEBUG, com.axelixlabs.axelix.sbs тоже переключится на DEBUG.
• У группы логгеров. Уровень применяется ко всем логгерам группы: если задать группе web уровень WARN, все её логгеры получат WARN.

Кнопка сброса возвращает логгер к уровню, который был у него до первого изменения в Axelix. Это работает для логгеров, изменённых во время работы: на этой странице, через MCP или прямым запросом к actuator-эндпоинту axelix-loggers. Уровень группы логгеров сбросить нельзя.

Временный уровень логирования

Скриншоты|Скриншоты соответствуют последнему минорному релизу Axelix.

Установка временного уровня логирования в интерфейсе Axelix

Когда подробные логи нужны лишь на время, например чтобы поймать ошибку, задайте временный уровень и не думайте о том, чтобы потом его выключить. Нажмите на иконку таймера рядом с логгером, выберите уровень и время, когда он должен закончиться. Если это время сегодня уже прошло, уровень будет действовать до этого времени завтра.

Когда время истечёт, логгер вернётся к уровню, который был у него раньше. Чтобы завершить временный уровень досрочно, сбросьте логгер. Для групп логгеров временный уровень недоступен.

MCP-инструменты

Чтение дерева логгеров и изменение уровней во время работы — для отдельного логгера, группы логгеров или сброса отдельного логгера — также доступны ИИ-агентам через MCP. См. Каталог MCP-инструментов.

Включите Нужный Actuator Ендпоинт

Страница работает поверх actuator-эндпоинта axelix-loggers, который добавляет Axelix Spring Boot Starter. Она доступна через стандартные свойства Spring Boot Actuator. Полный список конечных точек Axelix и сопутствующих настроек см. в разделе Настройка Spring Boot Starter:

management.endpoints.web.exposure.include=axelix-loggers

См. также

• Настройка Master
• Настройка Spring Boot Starter