Системный журнал#

Настройка системного журнала#

Просмотр сообщений системного журнала Kintsugi (DBCM) осуществляется с использованием стандартного потока вывода приложения.

Все сообщения системного журнала имеют формат человекочитаемого сообщения.

Предусмотрены следующие уровни журналирования:

ERROR − записываются сообщения обо всех ситуациях или событиях в приложении, которые считаются ошибочными:
- ошибки вызова внешних сервисов;
- ошибки интеграционных вызовов;
- ошибки, ведущие к падению одного из сервисов;
WARN – предупреждения о некорректной работе сервиса;
INFO – информация о работе приложения и текущем состоянии сервисов;
DEBUG – подробности о работе приложения, позволяющие восстановить последовательность выполнения операций при обслуживании запросов и вызовах внешних систем.

Примечание

Не рекомендуется использовать уровень логирования DEBUG в промышленной эксплуатации.

Доступ к системному журналу#

Для просмотра логов Kintsugi (DBCM) используйте команду мониторинга логов docker compose docker compose logs [<имя сервиса>].

Логи сервиса KgAgent компонента Kintsugi agent (DBDA) можно увидеть в системном журнале, так как он ставится на хосте.

Основные события#

Основные события сервисов, разработанных на языке Python#

В Platform V Kintsugi (DBM) следующие сервисы разработаны на языке Python: frontend, backend, curator, kmetrics, piface, dbterm, inform.

События данных сервисов регистрируются в формате: <Дата и время> | <Уровень логирования> | <Описание ошибки>.

Ниже приведены некоторые события логирования.

Уровень	Текст/шаблон сообщения	Перевод
`ERROR`	`app.routers.connections:get_database_list_impl:54 - an error occurred while trying to connect to the database to perform introspection action: [Error 104] Connection reset by peer`	Маршрутизация подключений: попытка подключения к базе данных для выполнения действия интроспекции завершилась неудачно: [Ошибка Error 104] Разрыв соединения по инициативе клиента
`ERROR`	`app.routers.connections:get_database_list_impl:54 - an error occurred while trying to connect to the database to perform introspection action: [Error 104] Connection reset by peer`	Маршрутизация подключений: попытка подключения к базе данных для выполнения действия интроспекции завершилась неудачно: [Ошибка Error 104] Разрыв соединения по инициативе клиента
`DEBUG`	`app.routers.probes:readiness:27 - readiness: positive response given`	Проверка готовности: положительный ответ дан
`DEBUG`	`app.routers.probes:liveness:33 - liveness: positive response given`	Проверка активности: положительный ответ дан
`WARN`	`inform.metrics.polling_modules.poll_queue:_is_first_element_ready:64 - poll_queue: (asset_id=307957a1-a7dd-15f7c13b63cc): early to poll. poll will be executed in 99.423 second(s)`	Очередь опроса метрик: элемент очереди (Asset ID=307957a1-a7dd-15f7c13b63cc): рано для опроса. Опрос будет выполнен через 99.423 секунды
`WARN`	`inform.metrics.polling_modules.poll_queue:_is_first_element_ready:64 - poll_queue: (asset_id=307957a1-a7dd-15f7c13b63cc): early to poll. poll will be executed in 75.986 second(s)`	Очередь опроса метрик: элемент очереди (Asset ID=307957a1-a7dd-15f7c13b63cc): рано для опроса. Опрос будет выполнен через 75.986 секунды
`INFO`	`logging:callHandlers:1661 - 127.X.X.X:Y - "GET /metrics HTTP/1.1" 200`	Информация о вызове обработчиков логирования: [IP-адрес]:[порт] - «GET /metrics HTTP/1.1» 200

Основные события сервисов, разработанных на языке Golang#

В Platform V Kintsugi (DBM) следующие сервисы разработаны на языке Golang: AgentWay, collector, dbperf, mcwatch, sheduler и KgAgent.

События данных сервисов регистрируются в формате: <Уровень ошибки> : <Дата и время> <Код файла и номер строки>: <Описание ошибки>.

Ниже приведены некоторые события логирования.

Уровень	Текст/шаблон сообщения	Перевод
`ERROR`	`ERROR: 2025/07/01 12:53:38.764808 dbconnector.go:447: Connector 73d09875-896c-cda644a394bd ( 10.X.X.X:Y /postgres ):: fail to connect: failed to connect to host=10.X.X.X user=postgres database=postgres: tls error (read tcp 192.X.X.X:Y->10.X.X.X:Y : read: connection reset by peer)`	Не удалось подключиться к хосту = 10.X.X.X пользователю = postgres базе данных = postgres: ошибка TLS (разрыв соединения по инициативе клиента)
`ERROR`	`ERROR: 2025/07/01 12:53:38.764924 dbconnector.go:177: Connector 73d09875-896c-cda644a394bd refreshed connections has inconsistent version info: no version info found`	Обновление соединений: версия обновленных соединений не совпадает с версией, которую предполагалось использовать. Версия не найдена
`DEBUG`	`DEBUG: 2025/07/01 13:10:23.521653 scraper.go:193: processing with promql map len = 39`	Обработка с помощью promql карты длины = 39
`DEBUG`	`DEBUG: 2025/07/01 13:10:23.521968 pipeline.go:32: Pipeline: Received duration = 0s`	Сборочная линия: Получено продолжительность = 0s
`WARN`	`WARN: 2025/07/01 12:53:48.760857 scraper.go:278: Scraper 73d09875-896c-cda644a394bd: metrics can not will be collected, 0 metrics sources available`	Метрики не могут быть собраны, 0 источников метрик доступны
`WARN`	`WARN: 2025/07/01 12:53:48.792487 dbconnector.go:374: Connector 01e28db3-3149-9ae8a169f7cf 10.X.X.X:Y/postgres: failed sql query = SELECT t2.rolname, t3.datname, (sum(t1.shared_blks_dirtied + t1.local_blks_dirtied)) * current_setting('block_size')::bigint AS dirty FROM pg_stat_statements t1 JOIN pg_roles t2 ON t1.userid = t2.oid JOIN pg_database t3 ON t1.dbid = t3.oid WHERE datname NOT IN ('template0', 'template1') GROUP BY rolname, datname ORDER BY dirty DESC LIMIT 25`	Ошибка SQL-запроса
`INFO`	`INFO: 2025/07/01 12:53:28.805985 dbconnector.go:298: Connector 01e28db3-3149-9ae8a169f7cf ( 10.X.X.X:Y/postgres ): 19 sources processed, query: (19 executed, 0 skipped, 3 failed), metrics: (36 created, 0 failed)`	19 источников обработано, запрос: (19 выполнено, 0 пропущено, 3 провалились), метрики: (36 созданы, 0 провалено)
`INFO`	`INFO: 2025/07/01 12:53:28.806204 scraper.go:257: Pipeline: maintenance has been finished, actual storage size, len = 108, cap = 1700`	Сборочная линия: техническое обслуживание было завершено, фактический размер хранилища, длина = 108, емкость = 1700

Описание событий «Error», приводящих к падению Kintsugi (DBCM)#

В целях ознакомления приведены сообщения, приводящие к падению Kintsugi (DBCM).

Сообщение	Сервис, сгенерировавший ошибку	Причина возникновения
`{{название сервиса}} error initialize configuration from {{название файла конфигурации}}: {{ошибка}}`	collector, dbterm	Ошибка инициализации конфигурации сервиса
`{{название сервиса}} error initialize logs from configuration {{название файла конфигурации}}: {{ошибка}}`	collector, dbterm	Ошибка инициализации логов сервиса
`error read queries from file {{название файла}}: {{ошибка}}`	collector	Ошибка чтения запросов метрик из файла
`error initializing queries from file {{название файла}}: {{ошибка}}`	collector	Ошибка инициализации запросов метрик из файла
`cannot build connection configuration: {{ошибка}}`	collector	Ошибка при попытке сформировать параметры подключения к наблюдаемой БД
`{{информация о подключении}}: nil pointer expected`	collector	Ошибка формирования подключения к БД
`{{информация о подключении}} bad connection information: {{подключение}}`	collector	Ошибка в сформированной строке подключения к БД

Описание событий типа «Error», приводящих к падению Kintsugi agent (DBDA)#

В таблице представлены примеры сообщений, приводящих к падению Kintsugi agent.

Сообщение	Сервис, сгенерировавший ошибку	Причина возникновения
`{{название сервиса}} error initialize configuration from {{название файла конфигурации}}: {{ошибка}}`	KgAgent	Ошибка инициализации конфигурации сервиса
`{{название сервиса}} error initialize logs from configuration {{название файла конфигурации}}: {{ошибка}}`	KgAgent	Ошибка инициализации логов сервиса

Настройка уровня логирования#

Настройка уровня логирования выполняется на этапе установки компонента Kintsugi (DBCM) и описано в разделе «Установка» документа «Руководство по установке».