Журнал трассировки службы сервера отчетов
Журнал трассировки сервера отчетов содержит подробнейшие сведения об операциях службы сервера отчетов, включая операции, выполняемые веб-службой сервера отчетов, диспетчером отчетов и приложением фоновой обработки. Файл журнала трассировки содержит избыточные сведения, которые записываются в другие файлы журналов, а также дополнительные сведения, недоступные иным способом. Данные журнала трассировки могут оказаться полезными при отладке приложения, содержащего сервер отчетов, либо при изучении конкретной проблемы, зафиксированной в журнале событий или журнале выполнения.
Примечание |
---|
В предыдущих версиях имелось несколько журналов трассировки, по одному на каждое приложение. В этом выпуске все данные журналов объединены в один файл. Следующие файлы устарели и больше не создаются в SQL Server 2008: ReportServerWebApp_<отметка времени>.log, ReportServer_<отметка времени>.log и ReportServerService_main_<отметка времени>.log. |
Просмотр данных журнала
Файлом журнала трассировки является ReportServerService_<отметка времени>.log. Журнал трассировки представляет собой текстовый ASCII-файл. Просмотреть этот файл можно в любом текстовом редакторе. Этот файл расположен в каталоге \Microsoft SQL Server\<Экземпляр SQL Server>\Reporting Services\LogFiles. Журнал трассировки создается ежедневно, при этом первая запись создается после полуночи (по местному времени) и каждый раз при перезапуске службы. Отметки времени создаются на основе времени по Гринвичу (UTC). Этот файл имеет формат EN-US. По умолчанию размер журналов трассировки ограничен 32 МБ, а срок их хранения — 14 дней.
Параметры конфигурации файла журнала ReportServerService
Уровни трассировки задаются свойствами DefaultTraceSwitch и RSTrace. Все параметры уровня трассировки хранятся в файле конфигурации ReportingServicesService.exe.config.
Этот файл конфигурации находится в папке \Program Files\Microsoft SQL Server\MSRS10_50.<имя_экземпляра>\Reporting Services\ReportServer\bin
Файл журнала ReportServerService.exe включен по умолчанию.
Чтобы отключить его, установите уровень трассировки равным 0 в разделе RStrace файла конфигурации ReportingServicesService.exe.config.
Чтобы ограничить количество дней, в течение которых хранятся эти файлы, укажите параметр конфигурации KeepFilesForDays в разделе RStrace. По умолчанию это значение равно 14.
Чтобы ограничить размер файла, укажите параметр конфигурации FileSizeLimitMb в разделе RStrace. По умолчанию это значение равно 32 мегабайтам. Размером файла можно управлять, устанавливая уровни трассировки (от 0 до 4), чтобы управлять объемом записываемого содержимого. Можно также указать, какие компоненты отслеживать. Если максимальный размер файла журнала будет достигнут за 14 дней до даты истечения срока хранения, то более старые записи будут замещаться более новыми.
Поля файла журнала
В журнале трассировки содержатся следующие данные:
сведения о системе, в том числе операционной системе, ее версии, числе процессоров и памяти;
сведения о компоненте и версии служб Службы Reporting Services;
события, регистрируемые в журнале приложений;
исключения, формируемые сервером отчетов;
предупреждения о нехватке ресурсов, регистрируемые сервером отчетов;
входящие пакеты SOAP и сводные исходящие пакеты SOAP;
сведения о заголовке HTTP, трассировке стека и трассировки при отладке.
Можно просмотреть сведения в журнале трассировки, чтобы определить, была ли выполнена доставка отчета, кто его получил, и сколько попыток доставки было сделано. Журналы трассировки также фиксируют операции при выполнении отчетов и переменные окружения, действующие при обработке отчетов. Ошибки и исключения также записываются в журналы трассировки. Например, можно узнать об ошибках превышения времени ожидания (отображаемых как записи ThreadAbortExceptions).
Пример настройки конфигурации
Следующий пример иллюстрирует 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 = Отключить трассировку 1 = Исключения и перезапуски 2 = Исключения, перезапуски, предупреждения 3 = Исключения, перезапуски, предупреждения, сообщения о состоянии (по умолчанию) 4 = Подробный режим |
FileName |
Задает первую часть имени файла журнала. Вторую часть имени определяет значение, заданное в аргументе Prefix. |
FileSizeLimitMb |
Задает максимальный размер журнала трассировки. Размер измеряется в мегабайтах. Допустимые значения: от 0 до максимального значения, заданного целым числом. Значение по умолчанию равно 32. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. |
KeepFilesForDays |
Определяет, через сколько дней журнал трассировки будет удален. Допустимые значения: от 0 до максимального значения, заданного целым числом. Значение по умолчанию равно 14. При указании значения 0 или отрицательного числа сервер отчетов воспримет их как 1. |
Prefix |
Задает формируемое значение, позволяющее отличить один экземпляр журнала от другого. По умолчанию к именам файлов журнала трассировки добавляются значения отметок времени. Значение этой величины — «tid, time». Не изменяйте этот параметр. |
TraceListeners |
Задает, куда будет выводиться содержимое журнала трассировки. Можно через запятую задать несколько расположений. Допустимые значения: DebugWindow File (по умолчанию) StdOut |
TraceFileMode |
Определяет, содержат ли журналы трассировки данные за 24-часовой период. Необходимо, чтобы каждому компоненту за каждый день соответствовал один уникальный журнал трассировки. Значение этой величины — Unique (по умолчанию). Не изменяйте это значение. |
Components |
Указывает компоненты, для которых формируется информация журнала трассировки, и уровень трассировки в следующем формате: <категория_компонента>:<уровень_трассировки> Категории компонентов можно установить следующим образом.
Допустимыми значениями уровня трассировки являются следующие. 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 базы знаний на сайте Майкрософт.
См. также