<< <%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 приведена инструкция по настройке полного имени файла при помощи меток. |