Журнал трассировки службы сервера отчетов
Журнал трассировки сервера отчетов Reporting Services — это текстовый файл ASCII, содержащий подробные сведения об операциях службы сервера отчетов, включая операции, выполняемые веб-службой сервера отчетов, диспетчером отчетов и фоновой обработкой. Файл журнала трассировки содержит избыточные сведения, которые записываются в другие файлы журналов, а также дополнительные сведения, недоступные иным способом. Данные журнала трассировки могут оказаться полезными при отладке приложения, содержащего сервер отчетов, либо при изучении конкретной проблемы, зафиксированной в журнале событий или журнале выполнения.
Примечание
В предыдущих версиях имелось несколько журналов трассировки, по одному на каждое приложение. Следующие файлы устарели и больше не создаются в SQL Server 2008 и более поздних версиях: ReportServerWebApp_<timestamp.log>, ReportServer_<timestamp.log> и ReportServerService_main_<timestamp.log>.
В этом разделе:
Где находятся файлы журналов сервера отчетов?
Файлы журнала трассировки ReportServerService_<timestamp>.log и находятся в следующей папке:
C:\Program Files\Microsoft SQL Server\MSRS12.MSSQLSERVER\Reporting Services\LogFiles
Журнал трассировки создается ежедневно, при этом первая запись создается после полуночи (по местному времени) и каждый раз при перезапуске службы. Отметки времени создаются на основе времени по Гринвичу (UTC). Этот файл имеет формат EN-US. По умолчанию размер журналов трассировки ограничен 32 МБ, а срок их хранения — 14 дней.
Просмотрите короткое видео, демонстрирующее использование microsoft Power Query для просмотра Reporting Services файлов журналов.
Параметры конфигурации трассировки
Управление поведением журнала трассировки осуществляется в файле конфигурации ReportingServicesrService.exe.config. Файл конфигурации находится в следующем пути к папке:
\Program Files\Microsoft SQL Server\MSRS12.<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="tid, time" />
<add name="TraceListeners" value="file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all" />
</RStrace>
Сведения об отдельных настройках приведены в следующей таблице.
| Параметр | Описание |
|---|---|
RStrace |
Задает пространства имен для ошибок и трассировки. |
DefaultTraceSwitch |
Задает уровень данных, записываемых в журнал трассировки ReportServerService. Каждый уровень содержит данные, передаваемые более низкими уровнями. Отключать трассировку не рекомендуется. Допустимые значения: 0 = Отключить трассировку Файл журнала ReportServerService.exe включен по умолчанию. Чтобы отключить его, установите уровень трассировки равным 0. 1 = Исключения и перезапуски 2 = Исключения, перезапуски, предупреждения 3 = Исключения, перезапуски, предупреждения, сообщения о состоянии (по умолчанию) 4 = Подробный режим |
| FileName | Задает первую часть имени файла журнала. Вторую часть имени определяет значение, заданное в аргументе Prefix. |
| FileSizeLimitMb | Задает максимальный размер журнала трассировки. Размер измеряется в мегабайтах. Допустимые значения: от 0 до максимально допустимого целого числа. Значение по умолчанию: 32. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. Размером файла можно управлять, устанавливая уровни трассировки (от 0 до 4), чтобы управлять объемом записываемого содержимого. Можно также указать, какие компоненты отслеживать. Если максимальный размер файла журнала будет достигнут за 14 дней до даты истечения срока хранения, то более старые записи будут замещаться более новыми. |
| KeepFilesForDays | Определяет, через сколько дней журнал трассировки будет удален. Допустимые значения: от 0 до максимально допустимого целого числа. Значение по умолчанию: 14. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. |
Prefix |
Задает формируемое значение, позволяющее отличить один экземпляр журнала от другого. По умолчанию к именам файлов журнала трассировки добавляются значения отметок времени. Значение этой величины — «tid, time». Не изменяйте этот параметр. |
| TraceListeners | Задает, куда будет выводиться содержимое журнала трассировки. Можно через запятую задать несколько расположений. Допустимые значения: DebugWindow File (по умолчанию) StdOut |
| TraceFileMode | Определяет, содержат ли журналы трассировки данные за 24-часовой период. Необходимо, чтобы каждому компоненту за каждый день соответствовал один уникальный журнал трассировки. Значение этой величины — Unique (по умолчанию). Не изменяйте это значение. |
Components |
Указывает компоненты, для которых формируется информация журнала трассировки, и уровень трассировки в следующем формате: <категория компонентов>: <уровень_трассировки> Категории компонентов можно установить следующим образом. Параметр All используется для трассировки общей активности сервера отчетов для всех процессов, которые не разбиваются на конкретные категории.Параметр RunningJobs применяется для трассировки формирования отчета или операции подписки.Параметр SemanticQueryEngine используется для трассировки семантических запросов, которые обрабатываются, когда пользователь проводит нерегламентированный просмотр данных отчета на основе моделей.Параметр SemanticModelGenerator применяется для трассировки формирования модели.Параметр http используется для включения файла журнала HTTP сервера отчетов. Дополнительные сведения см. в разделе Report Server HTTP Log.Допустимыми значениями уровня трассировки являются следующие. 0 = Отключить трассировку 1 = Исключения и перезапуски 2 = Исключения, перезапуски, предупреждения 3 = Исключения, перезапуски, предупреждения, сообщения о состоянии (по умолчанию) 4 = Подробный режим Значение по умолчанию для сервера отчетов: "all:3". Можно указать все или некоторые компоненты ( all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). Если нежелательно формировать информацию для конкретного компонента, можно отключить его трассировку (например, «SemanticModelGenerator:0»). Не отключайте трассировку для компонента all.Если уровень трассировки компонента не указан, используется значение, указанное для параметра DefaultTraceSwitch. Например, если указать «all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator», то для всех компонентов будет использоваться уровень трассировки по умолчанию.Можно установить «SemanticQueryEngine:4», если желательно видеть инструкции Transact-SQL, формируемые для каждого семантического запроса. Инструкции Transact-SQL записываются в журнал трассировки. Следующий пример иллюстрирует настройку конфигурации, которая добавляет в журнал инструкции Transact-SQL: <add name="Components" value="all,SemanticQueryEngine:4" /> |
Добавление настроек пользовательской конфигурации для указания местоположения файла дампа
Можно добавить пользовательскую настройку для задания местоположения, которое программа «Доктор Ватсон" для Windows использует для хранения файлов дампа. Пользовательское значение равно Directory. Следующий пример иллюстрирует, как эта настройка конфигурации указывается в разделе RStrace:
<add name="Directory" value="U:\logs\" />
Дополнительные сведения см. в статье 913046 базы знаний на сайте Microsoft .
Поля файла журнала
В журнале трассировки содержатся следующие данные:
сведения о системе, в том числе операционной системе, ее версии, числе процессоров и памяти;
Службы Reporting Services ;
события, регистрируемые в журнале приложений;
исключения, формируемые сервером отчетов;
предупреждения о нехватке ресурсов, регистрируемые сервером отчетов;
входящие пакеты SOAP и сводные исходящие пакеты SOAP;
сведения о заголовке HTTP, трассировке стека и трассировки при отладке.
Можно просмотреть сведения в журнале трассировки, чтобы определить, была ли выполнена доставка отчета, кто его получил, и сколько попыток доставки было сделано. Журналы трассировки также фиксируют операции при выполнении отчетов и переменные окружения, действующие при обработке отчетов. Ошибки и исключения также записываются в журналы трассировки. Например, можно узнать об ошибках превышения времени ожидания (отображаемых как записи ThreadAbortExceptions).
См. также:
Справочник по файлам журналов и источникамReporting Services об ошибках и событиях (Reporting Services)