Журнал трассировки службы сервера отчетов
Журналы трассировки сервера отчетов служб Reporting Services — это текстовый файл ASCII, содержащий подробные сведения об операциях службы сервера отчетов. Эти файлы включают сведения об операциях, выполняемых веб-службой сервера отчетов, веб-порталом и в процессе фоновой обработки. Файл журнала трассировки содержит избыточные сведения, записанные в других файлах журнала, а также дополнительные сведения, недоступные в противном случае. Сведения журнала трассировки полезны при отладке приложения, включающего сервер отчетов. Сведения также полезны, если вы изучаете определенную проблему, записанную в журнал событий или журнал выполнения. Например, при устранении неполадок с подписками.
Где находятся файлы журнала сервера отчетов?
Файлы журнала трассировки ReportServerService_<timestamp>.log и Microsoft.ReportingServices.Portal.WebHost_<timestamp>.log находятся в следующей папке:
C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\LogFiles
Журналы трассировки создаются ежедневно. При этом первая запись создается после полуночи (по местному времени) и каждый раз при перезапуске службы. Отметки времени создаются на основе времени по Гринвичу (UTC). Этот файл имеет формат EN-US. По умолчанию журналы трассировки ограничены 32 мегабайтами и по умолчанию удаляются через 14 дней.
Параметры конфигурации трассировки
Поведение журнала трассировки управляется в файле ReportingServicesService.exe.configконфигурации. Файл конфигурации расположен в следующей папке:
\Program Files\Microsoft SQL Server\MSRS13.<instance name>\Reporting Services\ReportServer\bin.
Следующий пример иллюстрирует XML-структуру параметров RStrace . Значение параметра DefaultTraceSwitch определяет тип информации, добавляемой в журнал. За исключением атрибута Components , значения для настройки RStrace одни и те же в разных файлах конфигурации.
\<system.diagnostics>
<switches>
<add name="DefaultTraceSwitch" value="3" />
</switches>
\</system.diagnostics>
<RStrace>
<add name="FileName" value="ReportServerService_" />
<add name="FileSizeLimitMb" value="32" />
<add name="KeepFilesForDays" value="14" />
<add name="Prefix" value="appdomain, tid, time" />
<add name="TraceListeners" value="file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all:3" />
</RStrace>
Сведения об отдельных настройках приведены в следующей таблице.
| Параметр | Description | Values |
|---|---|---|
| RStrace | Задает пространства имен для ошибок и трассировки. | |
| DefaultTraceSwitch | Указывает уровень информации, сообщаемой журналу ReportServerService трассировки. Каждый уровень содержит данные, передаваемые более низкими уровнями. Отключение трассировки не рекомендуется. |
Допустимые значения: 0 = Отключить трассировку Файл ReportServerService журнала включен по умолчанию. Чтобы отключить его, задайте для уровня трассировки значение 0.1= Exceptions and restarts2= Exceptions, restarts, warnings3= Exceptions, restarts, warnings, status messages (по умолчанию)4= Verbose mode |
| FileName | Задает первую часть имени файла журнала. Вторую часть имени определяет значение, заданное в аргументе Prefix . | |
| FileSizeLimitMb | Задает максимальный размер журнала трассировки. Размер измеряется в мегабайтах. Размером файла можно управлять, устанавливая уровни трассировки (от 0 до 4), чтобы управлять объемом записываемого содержимого. Можно также указать, какие компоненты отслеживать. Если максимальный размер файла журнала достигается до 14-дневной даты окончания срока действия, старые записи заменяются новыми записями. |
Допустимые значения: от 0 до максимально допустимого целого числа. Значение по умолчанию: 32. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. |
| KeepFilesForDays | Указывает количество дней после удаления файла журнала трассировки. | Допустимые значения: от 0 до максимально допустимого целого числа. Значение по умолчанию: 14. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. |
| Prefix | Задает формируемое значение, позволяющее отличить один экземпляр журнала от другого. | По умолчанию к именам файлов журнала трассировки добавляются значения отметок времени. Этот параметр имеет значение appdomain, tid, time. Не изменяйте этот параметр. |
| TraceListeners | Задает, куда будет выводиться содержимое журнала трассировки. Можно через запятую задать несколько расположений. | Допустимые значения:DebugWindowFile (по умолчанию)StdOut |
| TraceFileMode | Определяет, содержат ли журналы трассировки данные за 24-часовой период. Необходимо, чтобы каждому компоненту за каждый день соответствовал один уникальный журнал трассировки. | Этот параметр имеет значение Unique (default). Не изменяйте это значение. |
| Категории компонентов | Указывает компоненты, для которых формируется информация журнала трассировки, и уровень трассировки в следующем формате:\<component category>:\<tracelevel>Можно указать все или некоторые компоненты (all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). Если вы не хотите создавать сведения для определенного компонента, можно отключить трассировку (например, "SemanticModelGenerator:0"). Не отключать трассировку для всех. Можно установить «SemanticQueryEngine:4», если желательно видеть инструкции Transact-SQL, формируемые для каждого семантического запроса. Инструкции Transact-SQL записываются в журнал трассировки. Следующий пример иллюстрирует настройку конфигурации, которая добавляет в журнал инструкции Transact-SQL: <add name="Components" value="all,SemanticQueryEngine:4" /> |
Категории компонентов можно задать следующим образом: Все используется для трассировки общего действия сервера отчетов для всех процессов, которые не разбиты на определенные категории. ПараметрRunningJobs применяется для трассировки формирования отчета или операции подписки. SemanticQueryEngine используется для трассировки семантического запроса, обрабатываемого при выполнении пользователем незапланированного исследования данных в отчете на основе модели. ПараметрSemanticModelGenerator применяется для трассировки формирования модели. Параметрhttp используется для включения файла журнала HTTP сервера отчетов. Дополнительные сведения см. в разделе Report Server HTTP Log. |
| Значение уровня трассировки для категорий компонентов | <категория компонентов>: <уровень_трассировки> Если к компоненту не добавляется уровень трассировки, используется значение, указанное для DefaultTraceSwitch . Например, если указать all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator, все компоненты используют уровень трассировки по умолчанию. |
Допустимыми значениями уровня трассировки являются следующие.0= Disables tracing1= Exceptions and restarts2= Exceptions, restarts, warnings3= Exceptions, restarts, warnings, status messages (по умолчанию)4= Verbose modeЗначение по умолчанию для сервера отчетов: all:3 |
Добавление настраиваемого параметра конфигурации для указания расположения файла дампа
Можно добавить пользовательскую настройку для задания местоположения, которое программа «Доктор Ватсон» для Windows использует для хранения файла дампа. Пользовательское значение равно Directory. Следующий пример иллюстрирует, как эта настройка конфигурации указывается в разделе RStrace:
<add name="Directory" value="U:\logs\" />
Дополнительные сведения см. в статье базы знаний, 913046 на веб-сайте Майкрософт.
Поля файла журнала
В журнале трассировки содержатся следующие данные:
сведения о системе, в том числе операционной системе, ее версии, числе процессоров и памяти;
Сведения о компонентах и версиях служб Reporting Services.
события, регистрируемые в журнале приложений;
исключения, формируемые сервером отчетов;
предупреждения о нехватке ресурсов, регистрируемые сервером отчетов;
входящие пакеты SOAP и сводные исходящие пакеты SOAP;
сведения о заголовке HTTP, трассировке стека и трассировки при отладке.
Можно просмотреть сведения в журнале трассировки, чтобы определить, была ли выполнена доставка отчета, кто его получил, и сколько попыток доставки было сделано. Журналы трассировки также фиксируют операции при выполнении отчетов и переменные окружения, действующие при обработке отчетов. Ошибки и исключения также записываются в журналы трассировки. Например, можно найти ошибки времени ожидания отчета, указанные ThreadAbortExceptions как запись.
предыдущих версий
В предыдущих выпусках служб Reporting Services было несколько файлов журналов трассировки, по одному для каждого приложения. Следующие файлы устарели и больше не создаются в SQL Server 2008 (10.0.x) и более поздних версиях:
+ ReportServerWebApp_\<timestamp>.log
+ ReportServer_\<timestamp>.log
+ ReportServerService_main_\<timestamp>.log