Логи программы

<< <%SKIN-STRTRANS-SYNTOC%> >>

  ---

Логи программы

Для диагностики и анализа программа WebMap.NET ведет запись логов.

 

События, записываемые в Журнал, могут иметь разные уровень важности. По умолчанию установлен уровень логирования "Infо". Для изменения настроек логирования необходимо открыть файл nlog.config  в папке \inetpub\webmap на web-сервере.

 

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

• указать путь к папке, в которую будет сохраняться файл лога. Для этого нужно в файле nlog.config в раздел <targets> добавить строку: <target name="w3wp" xsi:type="File" fileName="${tempdir}\_WebMap_${date:format=yyyyMMdd}.log" layout="${date:format=HH\:mm\:ss} ${uppercase:upperCase=True:inner=${level}} ${message}"/>.

если такая строка уже есть, то достаточно отредактировать ее. В поле fileName= нужно задать полное имя файла, в который будет записываться лог. Полное название – это путь к этому файлу и название файла через символ «\». В самом простом случае расположение файла задается при

помощи метки, заключенной между ${}. Внутри фигурных скобок должна быть метка. После метки нужно ввести символ «\» и указать сам файл для записи лога. Имя файла также может содержать метки, например, метки даты, для того чтобы при создании файла лога в названии указывалась текущая дата. Например, при настройке fileName=»${tempdir}\WebMap_${date:format=yyyyMMdd}.log» лог будет сохраняться во временную папку системы (например, для ОС MS Windows 7 – это папка \Temp в директории текущего пользователя ПК), в файл WebMap_yyyyMMdd.log, причем вместо yyyyMMdd в названии файла будет указываться текущая дата.

• далее указать уровень логирования. Для этого в файле nlog.config в раздел <rules> добавить строку <logger name="w3wp" minLevel="Info" appendTo="w3wp"/>. Если такая строка уже есть, то достаточно отредактировать ее. Минимальный уровень логирования задается в поле minLevel=, например minLevel=«Info».

Предусмотрены следующие уровни логирования (в порядке возрастания приоритета):

Trace – очень детальный лог, который может содержать большой объем информации. Такой уровень логирования чаще используется разработчиками.

Debug – отладочная информация, менее детальная, чем при уровне Trace. В готовом продукте уровень Debug обычно отключен

Info – информационные сообщения, которые обычно разрешены в готовом ПО.

Warn – предупреждающие сообщения. Как правило, используются для не критических

ошибок и временных сбоев ПО, которые могут быть исправлены.

Error – сообщения об ошибках, чаще об исключениях.

 

ПРИМЕНЧАНИЕ

Журнал логирования в WebMAp.Net построен на платформе NLog. Подробнее о платформе и конфигурировании файла nlog.config см. на сайте https://github.com/NLog/NLog/wiki/Tutorial. На этой странице в разделе «Configuration» приведена инструкция по полной настройке логирования. Подробнее о способах настройки расположения файла логов см. в разделе «Layouts» на этой же странице. На странице https://github.com/NLog/NLog/wiki/Layout-renderers приведена инструкция по настройке полного имени файла при помощи меток.