|
<< Click to Display Table of Contents >> Администрирование (Windows) > Сопровождение работы системы > Лог-файлы во время работы Структура лог-файлов |
|
|
<< Click to Display Table of Contents >> Администрирование (Windows) > Сопровождение работы системы > Лог-файлы во время работы Структура лог-файлов |
|
Информация в записях лог-файлов для удобства чтения разделена на атрибуты. Список атрибутов отличается в зависимости от приложения, события которого записываются.
В большинстве записей лог-файлов присутствуют атрибуты:
Атрибут |
Описание атрибута |
t |
Дата и время события с указанием часового пояса |
l |
|
tab |
Идентификатор вкладки браузера |
mt |
Шаблон сообщения. Передается в формате строки или в структурированном формате JSON. Структурированный формат выделяется символами { и }. Может содержать параметры. В этом случае атрибут mt используется вместе с атрибутом args |
args |
Параметры шаблона сообщения. Используется вместе с атрибутом mt |
cust |
Дополнительная информация о свойстве или объекте системы. Может использоваться вместе с атрибутом mt или без него |
ex |
Исключение. По сравнению с mt содержит более детальную информацию. Стандартные атрибуты: •type – тип исключения; •m – сообщение об ошибке; •stack – стек исключения. Содержит информацию о последовательности вызова функций и помогает найти изначальную функцию, в которой произошла ошибка. Помимо стандартных атрибутов, может содержать дополнительные |
span |
Время выполнения действия: сохранение карточки, формирование отчета, открытие документа и т.д. Содержит название действия, время начала его выполнения, а также дополнительные атрибуты, например текущий статус |
tr |
|
bn |
Название браузера |
bv |
Версия браузера |
lg |
Название логгера |
v |
Версия приложения, сервиса, системы и т.п., в которой произошло событие, например версия Directum RX или веб-агента |
un |
Учетная запись пользователя в формате <Домен>\\<Имя пользователя> или <Имя пользователя> |
tn |
Код системы |
В записях лог-файла сервиса NOMAD дополнительно присутствуют атрибуты:
Атрибут |
Описание атрибута |
application |
Название и версия мобильного приложения |
userAgent |
Название и версия мобильного приложения, а также название и версия операционной системы мобильного устройства |
requestNumber |
Порядковый номер операции запроса |
requestUrl |
Запрашиваемый URL-адрес |
ip |
IP-адрес, с которого произошел запрос |
nomadVersion |
Версия сервиса NOMAD |
{ "t":"2023-01-18 09:05:33.157+04:00", "tr":"cl-3b6fac8b-9d4d0c" "l":"Warn", "tab":"NudNy", "mt":"Agent is busy and update was skipped.", "bn":"Chrome", "bv":"94.0.4606.81", "v":"4.2.0.001", "un":"Domain\\ardo_na", "tn":"DirectumRX" } |
{ "t":"2023-01-18 14:22:20.000+04:00", "tr":"cl-e1fc77aa" "l":"Info", "mt":"Document (id = 180132, ver = 1) was loaded successfully.", "lg":"document_handler:133", "v":"5.8.7.9007", "un":"Domain\\ardo_na", "tn":"DirectumRX" } |
{ "t": "2023-02-17 15:22:07.181+04:00", "l": "Info", "lg": "NomadServiceDispatcher", "mt": "GetObjects", "span": { "requestStatus": "Started", "sdn": 104, "forceUpdate": true, "cookie": "b39fd6e9-dacf..." }, "un": "Domain\\ardo_na", "lang": "ru-RU", "tn": "DirectumRX", "application": "Directum Solo v.2.13", "userAgent": "DirectumSolo-Android10/2.13.0.10000", "requestUrl": "https://company.ru/nomad/session.asmx", "requestNumber": "21", "ip": "5.142.40.137", "nomadVersion": "2.22.0.0", "v": "4.5.0.0051" } |
Для классификации ошибок используются уровни логирования. С их помощью можно определить типы ошибок и уровень важности, например, отличить критичную ошибку от предупреждения.
Выделяют следующие уровни:
•Fatal – критичные ошибки, прерывающие работу приложения;
•Error – ошибки, которые прерывают выполняемую операцию, но на работоспособность приложения это не влияет;
•Warning – предупреждения, пропускаются автоматически. Выполняемые операции не прерываются;
•Info – логирование значимых действий пользователя и приложения. По ним администратор может отследить всю последовательность действий до возникновения ошибки и устранить ее;
•Debug – отладочные сообщения. Помогают разработчику восстановить ход работы по этапам конкретного процесса в продуктивной системе;
•Trace – запись всех видов ошибок. Помогает разработчику отладить процесс на этапе разработки.
В лог-файлах веб-клиента и серверных лог-файлах может фиксироваться необязательный атрибут tr – информация о трассировке:
"tr":"cl-2c8a3c91-50bd4ac762"
Трасса содержит данные о выполнении конкретного действия в системе. Это позволяет группировать логически связанные запросы, например обработку запроса веб-клиента или сообщения RabbitMQ.
В зависимости от того, к чему относится логирование, информация фиксируется в одном из форматов:
•<TraceId>-<RequestId> – обработка HTTP-запроса;
•<TraceId>-<MessageId> –обработка сообщения очереди RabbitMQ.
Где:
•TraceId – идентификатор трассы, длина 8 символов. Кроме того, он содержит префикс приложения, с которого началась трасса: ws – трасса началась на веб-сервере, cl – на веб-клиенте и др. Например, в лог-файле сервиса ключей можно узнать, что трасса началась с действия пользователя в веб-клиенте;
•RequestId – идентификатор текущего HTTP-запроса, длина 6 символов;
•MessageId – идентификатор сообщения очереди, длина 10 символов.
Все идентификаторы, кроме префикса приложения, – строки в кодировке Base16.
| © Компания Directum, 2024 |
