Логирование

В серверных и настольных редакциях платформы формируется лог-файл — журнал регистрации, в котором фиксируется выполнение каждого узла, что позволяет в случае возникновения ошибки выявить ее местоположение и возможную причину.

Правила формирования лог-файла (имя файла, его максимальный размер, уровень логирования и др.) задаются параметрами логирования.

Примечание: До версии 6.5.0 используется кодировка ANSI, соответствующая локали пользователя, из-под которого запущен Loginom Server. Начиная с версии 6.5.0 — UTF8.

Уровни логирования

Уровень логирования — параметр, который позволяет контролировать, какие действия, происходящие в программе, нужно записывать в зависимости от требуемой детализации процесса. С увеличением уровня логирования детализация и занимаемая память будут увеличиваться.

При выборе одного уровня логирования сообщения уровня выше записываться не будут.

По умолчанию установлен уровень Информация. Этого уровня достаточно для простого пользования программой, так как уровни выше будут замедлять работу приложения.

Рассмотрим описание уровней логирования:

Уровень Трассировка чаще всего используется только во время отладки процесса, для обычного пользования достаточно уровня Информация.

Формат записи в лог

Каждая строка в файле журнала представляет собой сообщение в формате:

yyyy-mm-ddThh:mm:ss.mss level (process:thread>user:session:[requestID]) — message [paramJSON],

где

• yyyy-mm-ddThh:mm:ss.mss — дата и время с указанием миллисекунд (дата и время разделены литерой T);
• level — уровень логирования;
• process — имя запущенного процесса;
• thread — номер потока;
• user — имя пользователя, запустившего процесс;
• session — номер сессии;
• requestID — идентификатор запроса (необязательный параметр; присутствует, если процесс запущен из внешнего сервиса);
• message — текст сообщения;
• paramJSON — параметры в формате JSON (необязательный параметр).