Логирование в bpm'online. Log4net

Общие сведения

При возникновении проблем работы приложения для их локализации полезно включить логирование. В bpm'online выполняется логирование всех основных операций.

Для логирования используется решение log4net. Этот инструмент позволяет выполнять логирование параметров из разных архитектурных компонентов приложения в отдельные файлы логов.

Логирование ведется отдельно для загрузчика приложения и для конфигурации Default. Настройки логирования выполняются в конфигурационном файле ..\Terrasoft.WebApp\log4net.config.

Хранение логов

По умолчанию файлы с логами загрузчика находятся по пути:

[TEMP]\BPMonline\Site_[{SiteId}]\[{ApplicationName}]\Log\[{DateTime.Today}]

Например:

C:\Windows\Temp\BPMonline\Site_1\bpmonline7121\Log\2018_05_22

Файлы с логами конфигурации Default находятся по пути:

[TEMP]\BPMonline\Site_[{SiteId}]\[{ApplicationName}]\[ConfigurationNumber]\Log\[{DateTime.Today}]

Например:

C:\Windows\Temp\BPMonline\Site_1\bpmonline7121\0\Log\2018_05_22

Здесь в квадратных скобках указаны следующие переменные:

• [TEMP] — базовый каталог. По умолчанию для IIS используется каталог C:\Windows\Temp, а для Visual Studio (IIS Express) — C:\Users\{Имя пользователя}\AppData\Local\Temp.
• [{SiteId}] — номер сайта. Для IIS указан в расширенных настройках сайта (рис. 1). Для Visual Studio номер содержит значение 2.
• [{ApplicationName}] — название приложения (рис. 1).
• [ConfigurationNumber] — номер конфигурации. Конфигурация Default, как правило, имеет номер 0.
• [{DateTime.Today}] — дата логирования.

Рис. 1. — Расширенные настройки сайта в IIS

Изменение уровня логирования

По умолчанию уровень логирования для всех компонентов bpm'online установлен таким образом, чтобы обеспечить максимальную производительность приложения. Возможные уровни логирования в порядке возрастания приоритета:

• ALL — логирование всех событий. Существенно уменьшает производительность приложения.
• DEBUG — логирование всех событий при отладке.
• INFO — логирование ошибок, предупреждений и сообщений.
• WARN — логирование ошибок и предупреждений.
• ERROR — логирование всех ошибок.
• FATAL — логирование только ошибок, приводящих к прекращению работы компонента, для которого ведется логирование.
• OFF — логирование отключено.

Пример 1. Установить максимальный уровень логирования для всех компонентов

Для этого необходимо в XML-элементе <root> файла ..\Terrasoft.WebApp\log4net.config указать уровень ALL.

<root>
    <level value="ALL" />
    <appender-ref ref="commonAppender" />
</root>

Пример 2. При работе с SVN вести логирование только ошибок

Для этого необходимо в XML-элементе <logger name="Svn"> файла ..\Terrasoft.WebApp\log4net.config указать уровень ERROR.

<logger name="Svn" >
    <level value="ERROR" />
    <appender-ref ref="SvnAppender" />
</logger>