Поделиться через

Файлы журналов (документация по пакету SDK для .NET версии 1.14)

Microsoft Point of Service for .NET (POS for .NET) включает функцию ведения журнала для записи POS для .NET, объектов служб и событий приложений. Параметры ведения журнала считываются из раздела реестра POS для .NET, \HKLM\SOFTWARE\POSfor.NET\Logging, а записи записываются с помощью Logger класса.

Включение журнала

Ведение журнала включено, если раздел реестра \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled имеет любое ненулевое значение.

Размер файла журнала

Максимальный размер файла журнала указывается в разделе реестра \HKLM\SOFTWARE\POSfor.NET\Log\MaxLogFileSize МБ. Если этот размер файла превышается во время включения ведения журнала, ведение журнала остановится. В приложение не будет возвращено исключение или ошибка.

По умолчанию максимальный размер файла журнала составляет 10 мегабайт (МБ).

Расположение файла журнала

Раздел реестра \HKLM\SOFTWARE\POSfor.NET\Log\location используется для определения места записи файлов журнала.

По умолчанию это расположение устанавливается в переменную среды %TEMP%, которая в Windows по умолчанию использует каталог C:\Documents и Параметры\(имя пользователя)\Local Параметры\temp. Это каталог для каждого пользователя.

Имена файлов журнала

Имена файлов журнала состоят из трех элементов:

  • Имя базового файла, содержащееся в разделе реестра \HKLM\SOFTWARE\POSfor.NET\Logging\Name. Значение по умолчанию — PosFor.Net.
  • Метка времени в этом формате: (гггг-мм-дд hh-mm-ssZ)
  • Расширение файла .txt.

Это пример типичного имени файла журнала:

PosFor.Net(2006-08-10 18-33-29Z).txt

Заголовок файла журнала

Заголовок, содержащий такие сведения, как пользователь, ОС, вызывающий поток и процесс записывается в каждый файл журнала при его создании. Этот заголовок содержит следующие поля:

  • Текущий пользователь: имя текущего пользователя.
  • Имя компьютера: имя компьютера, создающего журнал.
  • Версия ОС: версия Windows, которая выполняется, включая пакеты обновления.
  • Среда выполнения .NET: версия среды выполнения .NET.
  • Идентификатор процесса: идентификатор PID процесса, создавшего файл журнала.
  • Идентификатор потока: поток, создавший журнал.
  • Максимальный размер файла журнала: максимальный размер файла, используемый для этого файла журнала.
  • Файл: имя исполняемого файла, создавшего файл журнала.
  • InternalName: внутреннее имя исполняемого файла.
  • OriginalFilename: исходное имя исполняемого файла.
  • FileVersion: сведения о версии, хранящиеся в исполняемом файле.
  • FileDescription: описание, хранящееся в исполняемом файле.
  • Продукт: описание продукта, хранящегося в исполняемом файле.
  • ProductVersion: версия файла, хранящейся в исполняемом файле.
  • Отладка: флаг отладки.
  • Исправлено: исправленный файл.
  • PreRelease: флаг предварительного выпуска.
  • PrivateBuild: флаг частной сборки.
  • SpecialBuild: Специальный флаг сборки.
  • Язык: язык, используемый для создания файла журнала.

Записи файлов журнала

Записи журнала можно создавать с помощью POS для .NET или приложения или объекта службы. Записи создаются путем вызова соответствующего метода в экземпляре класса Logger .

Каждая запись содержит следующие поля.

  • Timestamp.

  • Идентификатор потока, создавший запись.

  • Уровень важности. Каждая запись журнала отмечена уровнем важности, определяемой методом Loger .

    Тег важности в записях журнала Соответствующий метод ведения журнала
    INFO Logger.Info
    ПРЕДУПРЕЖДЕНИЕ Logger.Warning
    ОШИБКА Logger.Error

  • Строка имени, указанная кодом, который называется методом Logger . Эта строка указывается при вызове метода ведения журнала и может не обязательно содержать имя исполняемого файла.

  • Например, типичная запись в файле журнала будет выглядеть следующим образом: [8/10/2006 6:12:14 PM 2936 INFO Pos Обозреватель] Ввод нагрузки Обозреватель()

Комментарии

Если файл журнала открыт, и приложение вызывает Refresh() метод, файл закрывается и создается новый с обновленной меткой времени.

См. также

Справочные материалы

Основные понятия

Другие ресурсы