Все клиентские и серверные приложения BioTime могут вести журнал событий. В журнал событий записываются следующие данные:

  • сообщения о вызовах методов, возвращенные значения и т. д.;
  • сообщения об ошибках системы, выброшенных исключениях (в том числе и необработанных), включая весь стек метода, вызвавшего ошибку и/или исключение;
  • сообщения о статусе сервиса и/или приложения;
  • всевозможные информационные сообщения.

Журналы событий клиентских приложений хранятся на компьютере, на котором установлен BioTime Server. Там же хранится и журнал событий самого BioTime Server. Журналы событий Gate Server хранятся на компьютере, на котором установлен экземпляр Gate Server.

Журналы событий хранятся в папке C:\ProgramData\BioLink Solutions\TraceLogs.


Настройка диагностики событий на стороне клиента

Диагностика событий настраивается отдельно для каждого приложения BioTime. Для настройки диагностики событий на стороне клиента используется элемент <biolink.logbook> конфигурационного файла приложения.

С помощью этого элемента пользователь может:

  • включить/отключить ведение журнала событий данного клиентского приложения – атрибут enabled элемента biolink.logbook (true – диагностика событий включена, false – отключена);
  • настроить уровень детализации журнала исходя из приоритета сообщения (атрибуты threshold и include элемента <filter>).

Атрибут threshold может иметь следующие значения:

  • Trace – выводятся сообщения с самым низким приоритетом, т. е. все информационные сообщения, стеки вызовов, имена файлов и т. д.;
  • Info – выводятся информационные сообщения;
  • Warn – выводятся сообщения, на которые следует обратить внимание;
  • Error – выводятся сообщения об ошибках и/или исключениях, а также всевозможная справочная информация, позволяющая диагностировать ошибку (стек вызова, название метода, файла и т. д.);
  • Status – выводятся сообщения с максимальным приоритетом (только сообщения, информирующие о статусе элемента – dead или alive).

Атрибут include управляет включением/исключением значения поля threshold в/из настройки уровня детализации. Атрибут может иметь значения true или false.


Пример

Предположим, строка настройки уровня детализации выглядит следующим образом:

<filter threshold="Trac e" include="false" type… />


Это значит, что в журнал будут выводиться сообщения с уровнем Info и выше. Сообщения, имеющие уровень Trace, не будут отображаться в журнале.

Данная строка по своему значению равносильна следующей:

<filter threshold="Info" include="true" type… />


Общий вид элемента <biolink.logbook> конфигурационного файла клиентского приложения представлен ниже:

<biolink.logbook debug="false" enabled="true" serviceEndpointName="servic eName">

<dsaData defaultProvider="isf">

<providers>

<add strategyType="BioLink.LogBook.Loc alStrategy.IsolatedStorageStrategy,

BioLink.LogBook, Version=1.0.0.0, Culture=neutral, Public KeyToken=null" name="isf" type="BioLink.LogBook.Provider.Loc alStrategyProvider, BioLink.LogBook, Version=1.0.0.0, Culture=neutral, Public KeyToken=null" />

</providers>

<polic y retries="15" expiration="7.00:00:00" />

</dsaData>

<filters>

<filter threshold="Trac e" include="false" type="BioLink.LogBook.Filter.LogLevelFilter, BioLink.LogBook, Version=1.0.0.0, Culture=neutral, Public KeyToken=null" />

</filters>


</biolink.logbook>


Настройка диагностики событий на стороне сервера

Настройка диагностики событий на стороне сервера включает в себя ряд параметров, управляющих файлами журналов событий всех приложений BioTime.

Настройка диагностики событий на стороне сервера осуществляется с помощью редактирования файлов:

CIS.BioTime.Server.Win32Service.exe.config – для BioTime Server;

CIS.BioTime.Gate.Win32Service.exe.config – для Gate Server.


С помощью этих конфигурационных файлов можно настроить следующие параметры:

Атрибут
Описание
Возможные значения
RollFileExistsBehavior 
Перезапись файлов журнала.
  • overwrite – в случае совпадения имен файлов перезаписывает существующий файл; 
  • increment – создает новый файл с другим порядковым номером
RollInterval 
Параметры создания файлов журнала.
Атрибут определяет, как часто необходимо создавать новый файл.
  • Day – указывает, что новый файл журнала будет создаваться каждый день;
  • Hour – указывает, что новый файл журнала будет создаваться каждый час;
  • Minute – указывает, что новый файл журнала будет создаваться каждую минуту;
  • Month – указывает, что новый файл журнала будет создаваться каждый месяц;
  • None – значение данного атрибута не будет влиять на процесс создания новых файлов журнала (при отсутствии других ограничений, например, размера файла, все события будут записываться в один файл);
  • Week – указывает, что новый файл журнала будет создаваться каждую неделю;
  • Year – указывает, что новый файл журнала будет создаваться каждый год.

RollSizeKB
Максимальный размер файлов журнала.
При достижении файлом журнала указанного размера будет создан новый файл.

TimeStampPattern 
Параметры формирования имен файлов журнала.
Атрибут определяет, в каком формате добавлять дату к имени файла журнала.

DeleteBackupLogAfter 
Параметры удаления файлов журнала.
Атрибут определяет, по истечении какого промежутка времени следует удалять файлы журнала.