Настройка логов

Логи являются ключевым инструментом для мониторинга, отладки, аудита и обеспечения безопасности системы. Все логи Bercut ESB соответствуют единым стандартам структурирования, контекстности и безопасности.

Ключевые принципы логирования:

• Структурированность - все логи имеют единый формат с четко определенными полями
• Контекстность - каждый лог содержит информацию об операции, пользователе и окружении
• Корреляция - использование flow_id и span_id для отслеживания цепочек вызовов
• Безопасность - логи не содержат чувствительной информации
• Интеграция - поддержка Grafana Alloy для централизованного сбора и анализа.

Формат строки лога

Все логи, независимо от компонента-источника, имеют единую структуру. Каждая запись представляет собой строку с полями, разделенными символом | (вертикальная черта).

Общая структура записи:

<timestamptz> <timestamp> | type=<type> | level=<level> | service=<service> | pod_name=<podName> | resource_group=<resourceGroup> | thread=<thread> | request_id=<requestId> | user_id=<userId> | domain_id=<domainId> | domain_name=<domainName> | flow_id=<flowId> | flow_name=<flowName> | flow_version_id=<flowVersionId> | route_id=<routeId> | element_id=<elementId> | trace_id=<traceId> | span_id=<spanId> | process_id=<processId> | error_code=<errorCode> | title=<title> | msg=<msg>

Описание атрибутов лога

В таблице ниже приведено описание всех атрибутов, присутствующих в логах. Обратите внимание, что значения некоторых полей различаются для Design Time и Run Time.

Атрибут	Описание	Значение (правила формирования)
		Design Time	Run Time
timestamptz	Время возникновения события	Системное время в часовом поясе UTC+0 в формате ISO 8601: YYYY-MM-DDThh:mm:ss.sssZ	Системное время в часовом поясе UTC+0 в формате ISO 8601: YYYY-MM-DDThh:mm:ss.sssZ
timestamp	Время возникновения события	Системное время в часовом поясе UTC+3 в формате: YYYY-MM-DD hh:mm:ss.sss	Системное время в часовом поясе UTC+3 в формате: YYYY-MM-DD hh:mm:ss.sss
type	Тип лога	AUDIT APPLICATION ACCESS	APPLICATION_DEBUG APPLICATION ACCESS
level	Уровень логирования	INFO ERROR DEBUG WARNING FATAL TRACE	INFO ERROR DEBUG WARNING TRACE
service	Имя сервиса	Всегда esb-backend	Имя сервиса, заданное при установке
pod_name	Идентификатор контейнера	Уникальный идентификатор Docker-контейнера, в котором развернут экземпляр сервиса	Уникальный идентификатор Docker-контейнера, в котором развернут экземпляр сервиса
resource_group	Ресурсная группа	ID ресурсной группы (всегда 1)	ID ресурсной группы (всегда 1)
thread	Идентификатор Java потока	Не заполняется	ID Java-потока, обрабатывающего роут
request_id	Идентификатор запроса	UUID, сгенерированный на стороне Design Time Backend	UUID, сгенерированный на стороне API Gateway
user_id	Идентификатор пользователя	ID текущего пользователя в системе	Не заполняется
domain_id	Идентификатор домена	ID текущего домена	ID домена, к которому относится исполняемый поток
domain_name	Имя домена	Имя домена, заданное пользователем	Имя домена, заданное пользователем
flow_id	Идентификатор потока	ID текущего потока	ID исполняемого потока (берется из поля meta.flowId файла конфигурации)
flow_name	Имя потока	Имя потока, заданное пользователем	Имя потока, заданное пользователем
flow_version_id	Идентификатор версии потока	ID текущей версии потока	ID исполняемой версии потока
route_id	Идентификатор части потока	Не заполняется	ID текущей выполняемой части (route) потока
element_id	Идентификатор элемента потока	Не заполняется	ID компонента, для которого генерируется лог
trace_id	Идентификатор трейса	UUID, сгенерированный на стороне Design Time Backend	UUID, сгенерированный на стороне Core
span_id	Идентификатор спана	UUID спана, сгенерированный на стороне Design Time Backend	UUID спана, сгенерированный на стороне Core
process_id	Идентификатор процесса	UUID, сгенерированный на стороне Design Time Backend	UUID, сгенерированный инициатором процесса
error_code	Код ошибки	Код ошибки (используется при логировании ошибок)	Код ошибки (используется при логировании ошибок)
title	Заголовок ошибки	Заголовок ошибки (используется при логировании ошибок)	Заголовок ошибки (используется при логировании ошибок)
msg	Сообщение	Текст логируемого сообщения	Текст логируемого сообщения

Фильтрация в дашборде Application Logs View

Представление логов на дашборде Application Logs View проиллюстрировано рисунком ниже.

Preview

Дашборд Application Logs View

На дашбороде Application Logs View вы можете настроить фильтрацию логов по следующим полям:

• Environment
• Application Instance - например, Core, license-manager, configuration-server
• Logs Type - тип логов, выбор из списка: APPLICATION, ACCESS, AUDIT и APPLICATION_DEBUG
• Период логирования, например, "Last 6 hours"
• Refresh - частота обновления логов, например, 10s
• Trace Id - идентификактор трейса
• Route Id - идентификатор маршрута

Фильтрация в Drilldown - Logs

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

Preview

Раздел Drilldown - Logs

Фильтрация в Explore

В разделе Explore вы можете строить сложные запросы для вывода логов по разным параметрам и поиска нужного текста в логах (например, текст сообщения об ошибке).

Preview

Раздел Explore. Хранилище Loki

Примеры записей

Ниже приведены примеры логов для различных компонентов и типов.

Пример 1: Design Time, тип APPLICATION

Лог прикладного события в Design Time

2026-06-24T08:51:00.252Z 2026-06-24 11:51:00.252 | type=APPLICATION | level=INFO | service=esb-backend | pod_name=9f40539931f7 | resource_group=1 | thread= | request_id=cbc80cb6-ebec-4329-b7dc-37d8a964afa3 | user_id=91099aba-c792-4aeb-a87f-5004c2feb9c7 | domain_id=82b56174-2133-4f0a-9d96-630bd99a4ba4 | domain_name=Обработка запросов к БД | flow_id=2499bf77-2258-4cee-aaa0-dd814d36b2fe | flow_name=Обработка SQL‑запросов | flow_version_id=3c9c5e19-2420-40a1-ae92-8bb319264e8e | route_id= | element_id= | trace_id=2dd8d05d5be0d2a70a701d04b716e097 | span_id=3970e03f5dcbbe3b | process_id=79d4b58d-57e1-40db-827c-eda76b5691e7 | error_code= | title= | msg="Linked..."

Пример 2: Design Time, тип AUDIT

Аудиторский лог действий пользователя в Design Time

2026-06-24T08:51:00.252Z 2026-06-24 11:51:00.252 | type=AUDIT | level=INFO | service=esb-backend | pod_name=9f40539931f7 | resource_group=1 | thread= | request_id=cbc80cb6-ebec-4329-b7dc-37d8a964afa3 | user_id=91099aba-c792-4aeb-a87f-5004c2feb9c7 | domain_id=82b56174-2133-4f0a-9d96-630bd99a4ba4 | domain_name=Обработка запросов к БД | flow_id=2499bf77-2258-4cee-aaa0-dd814d36b2fe | flow_name=Обработка SQL‑запросов | flow_version_id=3c9c5e19-2420-40a1-ae92-8bb319264e8e | route_id= | element_id= | trace_id=2dd8d05d5be0d2a70a701d04b716e097 | span_id=3970e03f5dcbbe3b | process_id=79d4b58d-57e1-40db-827c-eda76b5691e7 | error_code= | title= | msg="User initiated..."

Пример 3: Run Time, тип APPLICATION

Лог прикладного события во время выполнения потока

2026-06-24T08:51:00.252Z 2026-06-24 11:51:00.252 | type=APPLICATION | level=INFO | service=Core | pod_name=9f40539931f7 | resource_group=1 | thread=GlobalAsync-13 | request_id=cbc80cb6-ebec-4329-b7dc-37d8a964afa3 | user_id= | domain_id=82b56174-2133-4f0a-9d96-630bd99a4ba4 | domain_name=Обработка запросов к БД | flow_id=2499bf77-2258-4cee-aaa0-dd814d36b2fe | flow_name=Обработка SQL‑запросов | flow_version_id=3c9c5e19-2420-40a1-ae92-8bb319264e8e | route_id=019ef995-8f44-7219-95fe-549ce635fa23 | element_id=3a65c1f4-fb35-4894-9550-2edb45d2d5c4 | trace_id=2dd8d05d5be0d2a70a701d04b716e097 | span_id=3970e03f5dcbbe3b | process_id=79d4b58d-57e1-40db-827c-eda76b5691e7 | error_code= | title= | msg="Some..."

Пример 4: Run Time, тип APPLICATION_DEBUG

Отладочный лог во время выполнения, содержит более детальную информацию

2026-06-24T08:51:00.252Z 2026-06-24 11:51:00.252 | type=APPLICATION_DEBUG | level=INFO | service=Core | pod_name=9f40539931f7 | resource_group=1 | thread=GlobalAsync-13 | request_id=cbc80cb6-ebec-4329-b7dc-37d8a964afa3 | user_id= | domain_id=82b56174-2133-4f0a-9d96-630bd99a4ba4 | domain_name=Обработка запросов к БД | flow_id=2499bf77-2258-4cee-aaa0-dd814d36b2fe | flow_name=Обработка SQL‑запросов | flow_version_id=3c9c5e19-2420-40a1-ae92-8bb319264e8e | route_id=019ef995-8f44-7219-95fe-549ce635fa23 | element_id=3a65c1f4-fb35-4894-9550-2edb45d2d5c4 | trace_id=2dd8d05d5be0d2a70a701d04b716e097 | span_id=3970e03f5dcbbe3b | process_id=79d4b58d-57e1-40db-827c-eda76b5691e7 | error_code= | title= | msg="Before execution:..."