Бастион-2. Руководство администратора
Логи могут быть расположены в папке установки АПК «Бастион-2», либо в папке Logs отладочного сервиса.
Логи могут содержать информацию об исключениях, возникших при выполнении программных модулей, протоколы отправки и получения различных данных и другую информацию.
При обращении в техническую поддержку может понадобиться предоставить эти журналы для анализа специалистами.
6.2 Отладочный сервис
6.2.1Общие сведения
В комплект поставки АПК «Бастион-2» входит отладочный сервис (NDebugSvc) для протоколирования отладочных сообщений системы.
Все сообщения, выводимые через отладочный сервис, могут записываться в файлы (по умолчанию – выключено).
Отладочный сервис может автоматически переименовывать или удалить лог-файлы при достижении ими заданного размера.
По умолчанию, лог-файлы сохраняются в каталог <ProgramFiles(x86)>\ESProm\Tools\NDebug\Logs. Для включения режима записи отладочных сообщений можно запустить файл <ProgramFiles(x86)>\ES-Prom\Tools\NDebug\debug_mode_on.reg. Для отключения режима записи отладочных сообщений – файл <ProgramFiles(x86)>\ESProm\Tools\NDebug\debug_mode_off.reg.
6.2.2 Настройки отладочного сервиса АПК «Бастион-2»
Настройки отладочного сервиса сохраняются в системном реестре:
HKEY_LOCAL_MACHINE \SOFTWARE\ES-prom\NDebug
Основные настройки:
DebugMode |
DWORD |
Если = 0, то вывод отладочных сообщений и запись их в файл отключена. |
|
|
Если = 1, то вывод отладочных сообщений и запись их в файл включена. |
|
|
Значение по умолчанию – 1. |
WriteLog |
DWORD |
Если = 0, то запись отладочных сообщений в файл отключена. |
|
|
Если = 1, то запись отладочных сообщений в файл включена. |
|
|
Значение по умолчанию – 1. |
LogPath |
STRING |
Полный путь к каталогу, где будут храниться лог-файлы. |
|
|
По умолчанию все лог-файлы хранятся в каталоге Logs, находящегося в |
|
|
каталоге в том же каталоге, куда установлен отладочный сервис АПК |
|
|
«Бастион-2». Если невозможно определить путь к установленному |
|
|
отладочному сервису АПК «Бастион-2», то лог файлы будут храниться в |
|
|
системном каталоге Windows. |
Бастион-2. Руководство администратора
LogSizeLimit |
DWORD |
Максимальный размер лог-файла в МБ. |
|
|
|
||||
|
|
При |
достижении |
указанного |
размера |
лог-файл |
будет |
||
|
|
переименовываться путем добавления числа в конец названия файла, |
|||||||
|
|
например, bastion.log.1, bastion.log.2 и т.д. |
|
|
|
||||
|
|
По умолчанию – 0. |
|
|
|
|
|
||
DeleteOldLog |
DWORD |
Если = 1, то будет сохраняться только последний и предпоследний лог- |
|||||||
s |
|
файл. То есть при достижении лог файлом заданного размера, все |
|||||||
|
|
старые |
лог файлы будут удаляться, текущий лог-файл |
||||||
|
|
переименовываться, а запись последующих сообщений будет |
|||||||
|
|
осуществляться в новый лог-файл. |
|
|
|
|
|||
|
|
По умолчанию – 1. |
|
|
|
|
|
||
LogMessageF |
STRING |
Формат строки лога. |
|
|
|
|
|
||
ormat |
|
|
|
|
|
|
|
|
|
|
|
Для указания формата используется строка, в которой через запятую |
|||||||
|
|
указывается порядок вывода параметров лога. |
|
|
|
||||
|
|
Условные обозначения параметров лога следующие: |
|
|
|
||||
|
|
PN - имя приложения |
|
|
|
|
|
||
|
|
PID - идентификатор приложения (Thread ID) |
|
|
|
||||
|
|
MOD - модуль |
|
|
|
|
|
||
|
|
EVT - тип события |
|
|
|
|
|
||
|
|
MSG - сообщение |
|
|
|
|
|
||
|
|
По умолчанию – «PN,PID,MOD,MSG», что будет выглядеть следующим |
|||||||
|
|
образом: |
|
|
|
|
|
||
|
|
[30.06.2009 15:11:01] [OperandProt.dll] [00000ADC] [Бастион-Операнд] |
|||||||
|
|
(COM3) OperandDrv Create |
|
|
|
|
|||
LogsFilename |
STRING |
В этой ветке находятся настройки протоколирования, |
которые |
||||||
s |
|
позволяют выводить лог от различных модулей в разные файлы. |
|||||||
|
|
Все параметры в данной ветке являются строковыми. |
|
|
|||||
|
|
Наименование параметра определяет фильтр, по которому будут |
|||||||
|
|
выбираться сообщения, а значение параметра определяет имя файла, в |
|||||||
|
|
который будет сохраняться сообщения. |
|
|
|
||||
|
|
Внимание! Необходимо указывать только имя файла без пути. |
|
|
|||||
|
|
Пример: |
|
|
|
|
|
||
|
|
|
|
Имя параметра |
Значение параметра |
|
|||
|
|
|
|
(фильтр) |
|
(имя лог-файла) |
|
|
|
|
|
|
Bastion.* |
|
bastion.log |
|
|
|
|
|
|
|
ndebugwin.* |
|
ndebug.log |
|
|
|
|
|
|
|
BNetSvc.* |
|
bnetsvc.log |
|
|
|
|
|
|
|
Bastion.Операнд |
|
operand.log |
|
|
|
|
|
|
|
OperandProt.* |
|
operand.log |
|
|
|
|
|
|
|
Bastion.Elsys |
|
elsys.log |
|
|
|
|
|
|
Фильтр состоит из двух частей: первая часть (до точки) – имя |
|||||||
|
|
исполняемого файла, вторая – фильтр событий. |
|
|
|
||||