Группа настроек "Журналирование"

Некоторые настройки журналирования Web-клиента перенесены в интерфейс консоли.

Рисунок 1. Группа настроек "Журналирование"

Включить журнал событий навигации: По умолчанию протоколирование событий навигации отключено. Администратор может включить^[1] ведение журнала для записи информации о событиях и последующего анализа ошибок при помощи данного флага. В лог браузера записывается информация о специальных навигационных обработчиках, передаваемым им параметрах и результатах их работы.

Логирование сообщений браузера: Отправлять сообщения браузера в журнал операций Web-клиента. По умолчанию отправка сообщения браузера в журнал операций отключена^[2]. Администратор может включить отправку при помощи данного флага.

Логирование запросов

Включить журналирование запросов: Включение/отключение протоколирования событий сервера Web-клиента^[3]. Значение по умолчанию: неопределено. В стандартной конфигурации остальные настройки группы отсутствуют.

Путь к журналу запросов: Расположение папки с файлами журнала запросов^[4].

Журналируемые поля: По умолчанию указываются запросы, ответы, заголовки, дата/время (записывается в формате UTC) и имя сервера^[5]. Значения разделяются запятой. Со всеми допустимыми значениями можно ознакомиться в документации Microsoft.

Размер файла журнала, байт: Максимальный размер файла журнала, после которого будет создаваться новый^[6]. Значение в байтах, по умолчанию 10485760 байт (10 Мб). Цифра 0 означает отсутствие ограничения по размеру.

Количество файлов журнала: Количество сохраняемых файлов журнала, старые файлы будут удалены после появления новых^[7]. Допустимые значения от 1 до 10000, по умолчанию используется 4.

Префикс имени файла журнала: Префикс имени файла журнала^[8]. К префиксу прибавляется дата и номер файла в формате ГГГММДД.X, где X — порядковый номер журнала. Файл располагается по пути /var/log/docsvision/webclient/, например /var/log/docsvision/webclient/webclient-w3c-20350226.1.txt.

Настройка в конфигурационном файле

Возможность настроить журналирование NLog (см. подробнее "Протоколирование запросов с помощью NLog") с помощью конфигурационного файла поддерживается в качестве обратной совместимости.

{
  "NLog": {
    "targets": {
      "logFile": {
        "type": "File",
        "fileName": "${gdc:baseLogFolder}/docsvision/webclient/webclient.log",
        "layout": "[${longdate}][${level}][${callsite}] ${message} ${onexception:${newline}${exception:maxInnerExceptionLevel=10:format=shortType,message,stacktrace:separator=*:innerExceptionSeparator=&#xD;&#xA;&#x9;}}"
      },
    "rules": [
      {
        "logger": "*",
        "minLevel": "Error",
        "writeTo": "logFile"
      },
      {
        "logger": "*",
        "minLevel": "Trace",
        "writeTo": "logConsole"
      }
    ]
  }
}

1. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "EnableRouterLogging".

2. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "ApplyAggregatesButton".

3. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging IsEnabled".

4. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging LogDirectory".

5. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging LoggingFields".

6. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging FileSizeLimit".

7. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging RetainedFileCountLimit".

8. Аналогичный параметр в конфигурационном файле модуля Web-клиент — "W3CLogging FileName".