Настройка журналирования

События Web-клиента протоколируются с помощью компонента NLog (http://nlog-project.org).

Для каждой используемой БД в режиме мультитенантности ведётся свой журнал, например: WebClient_DataBseName_ГГГГ-ММ-ДД.

Базовые настройки журналирования представлены в панели управления (Раздел "WebClient"). Расширенные настройки осуществляются в конфигурационном файле Web-клиента.

  1. Откройте конфигурационный файл Каталог-установки-Web-клиента\5.5\Site\web.config.

  2. Перейдите к секции configuration  nlog.

  3. Измените параметры журналирования.

    Измените значение атрибута fileName элемента targets  target  target, чтобы настроить путь для сохранения журнала работы.

    В fileName можно использовать допустимые для Nlog переменные (https://github.com/nlog/NLog/wiki/File-target), например: C:\Logs\${level}\WebClient_${shortdate}.log.

    Измените значение атрибута level элемента rules  logger, например, на trace, чтобы включить протоколирование всех типов событий.

    Допустимые уровни протоколирования приведены на странице https://github.com/nlog/NLog/wiki/Configuration-file#log-levels.

    Для получения дополнительной информации о других настройках NLog обратитесь к документации по данной платформе.

  4. Сохраните изменения конфигурационного файла.

    Уровень журналирования может быть изменён методом /api/Log/SetLogLevel, если пользователь, который вызывает метод, состоит в группе DocsVision Administrators. Методом можно задать следующие уровни: Trace = 0, Debug = 1, Info = 2, Warn = 3, Error = 4 (любое другое значение будет распознано как Error).

    Данный способ применим для случая, когда есть потребность не перезагружать пул Web-клиента. После рестарта IIS уровень журналирования будет возвращён в исходное состояние в соответствии с конфигурационным файлом.