3 LogFormat
Дмитрий Кононов edited this page 1 year ago

###Описание формата журнальных файлов###

В папке с установленным ТК находится директория с журнальными файлами TerminalClient\logs*.log|*.7z

Файлы именуются в соответствии с текущей датой и именем подсистемы (YYYY.MM.DD Name.log) Журналы предыдущих дней архивируются в архивы формата 7zip, в той же директории YYYY.MM.DD_logs.7z

Имена логов:

  • Ad – рекламная подсистема
  • BillAcceptor on COMx - купюроприёмник
  • CoinAcceptor on COMx - монетоприёмник
  • Connection – установка/обрыв/проверка соединения с интернет
  • FirmwareUpload - сценарий обновления прошивки устройств
  • Funds - лог движения наличных и безналичных средств
  • GnivcFiscalization - проект облачной фискализации ГНИВЦ
  • Health – мониторинг состояния компьютера терминала
  • HID – журнал подсистемы сбора информации с устройств ввода (сканер, камера, кард-ридер)
  • Interface – подсистема отображения пользовательского интерфейса MessageQueueClient - лог обмена сообщениями между компонентами ПО
  • Monitoring – клиент сервера мониторинга терминалов Киберплат
  • Payments - система проведения платежей
  • PinLoader – загрузчик номиналов скретч-карт
  • Platru - платёжная книжка Киберплат
  • Printer – системный принтер
  • Printer on COMх - принтер
  • POSPrinter on COMx – POS принтер
  • QtMessages – общие системные ошибки ПО
  • ReportBuilder - отчёты создаваемые системой обновления
  • Scanner - сканер штрих-кодов
  • Scheduler – журнал внутреннего планировщика задач
  • TerminalClient – общий журнал терминального клиента. Отмечает отановку/загрузку основного модуля ПО. Загрузки конфигурации и подключаемых модулей.
  • Updater/UpdaterTrace - система обновления
  • UserAssistant - помощник абонента
  • WatchService - модуль управления запуска/остановки ПО
  • WatchServiceController - лог программы tray.exe
  • Watchdog – журнал драйвера сторожевого устройства

Общий вид записи в журнале:

hh.mm.ss.zzz [L] Message

Где L - это уровень сообщения:

  • D - отладочное сообщение, предназначено только для разработчиков
  • I - информационное сообщение (любое штатное сообщение)
  • W - предупреждение
  • E - ошибка, после которой функционирование программы возможно
  • C - критическая ошибка, после которой, как правило, функционирование ПО невозможно.

Каждый запуск о остановка терминального клиента отмечается в журнале TerminalClient записями на подобие:

02:45:14.670 [I] ******************************** LOG [TerminalClient] STOP.
02:45:18.585 [I] ******************************** LOG [TerminalClient] STARTED. TerminalClient 3.4.0 build 201502161846.

Каждый случай отсутствия записи об успешной остановке сервиса можно рассматривать как нештатную ситуацию. Возможные причины:

  • принудительная остановка через менеджер задач
  • обесточивание терминала (в этом случае практически одновременно будут оборваны все журнальные файлы)
  • принудительная остановка основного модуля в следствии не ответа на контрольные запросы (например из-за подвисание главного потока ПО, события отмечаются в WatchService.log)
  • падение ПО в следствии ошибки