Журналы трассировки служб Reporting Services
Журналы трассировки содержат подробные сведения об операциях сервера отчетов. Они включают избыточные сведения, которые записываются в другие файлы журналов, а также дополнительные сведения, не доступные иными средствами. Журналы трассировки полезны в случае отладки приложения, содержащего сервер отчетов, либо изучения конкретной проблемы, зафиксированной в журнале событий или журнале выполнения.
Журналы трассировки создаются ежедневно, при этом их первая запись содержит данные о событиях после полуночи (по местному времени). Имя файла журнала трассировки формируется с использованием локального времени компьютера. По умолчанию размер журналов трассировки ограничен 32 МБ, а срок их хранения — 14 дней.
Поиск журналов трассировки
Службы SQL Server Reporting Services предоставляют четыре файла журналов трассировки, которые размещены в папке \Microsoft SQL Server\<Экземпляр SQL Server>\Reporting Services\LogFiles. Они описаны в таблице ниже.
| Имя файла журнала | Описание |
|---|---|
ReportServerService_<временная_метка>.log |
Журнал трассировки рабочих потоков службы сервера отчетов Windows. |
ReportServerService_main_<временная_метка>.log |
Журнал трассировки управляющих потоков службы сервера отчетов Windows. |
ReportServerWebApp_<временная_метка>.log |
Журнал трассировки для диспетчера отчетов. |
ReportServer_<временная_метка>.log |
Журнал трассировки для веб-службы сервера отчетов. |
Просмотр данных журнала
Журналы трассировки — это текстовые файлы. Для их просмотра можно использовать любой текстовый редактор. В журнале трассировки содержатся следующие сведения:
- сведения о системе, в том числе операционной системе, ее версии, числе процессоров и памяти;
- сведения о компоненте и версии служб Reporting Services;
- события, регистрируемые в журнале приложений;
- исключения, формируемые сервером отчетов;
- предупреждения о нехватке ресурсов, регистрируемые сервером отчетов;
- входящие пакеты SOAP и сводные исходящие пакеты SOAP;
- сведения о заголовке HTTP, трассировке стека и трассировки при отладке.
Можно просматривать журналы трассировки для определения того, была ли выполнена доставка отчета, кто его получил и сколько попыток доставки было сделано. Журналы трассировки также фиксируют операции при выполнении отчетов и переменные окружения, действующие при обработке отчетов. Ошибки и исключения также записываются в журналы трассировки. Например, можно узнать об ошибках превышения времени ожидания (указываемых в записи ThreadAbortExceptions).
Задание уровней трассировки
Уровни трассировки задаются свойствами DefaultTraceSwitch и RSTrace. Каждый компонент хранит параметры уровней трассировки в отдельном файле конфигурации. Для управления объемом информации, записываемой в каждый журнал, надо изменить настройки в соответствующем файле конфигурации.
| Имя файла журнала компонента | Файл конфигурации с настройками трассировки |
|---|---|
ReportServerService_<временная_метка>.log и ReportServerService_main_<временная_метка>.log |
Файл ReportingServicesService.config Дополнительные сведения см. в разделе Файл конфигурации ReportingServicesService. Изменения в файле конфигурации вступают в силу после перезапуска службы Windows. |
ReportServerWebApp_<временная_метка>.log |
Файл Web.config для диспетчера отчетов, расположенный в папке Program Files\SQL Server\MSSQL.n\Reporting Services\ReportManager Изменения файла конфигурации вступают в силу немедленно. |
ReportServer_<временная_метка>.log |
Файл Web.config для веб-служб сервера отчетов, расположенный в папке Program Files\SQL Server\MSSQL.n\Reporting Services\ReportServer Изменения файла конфигурации вступают в силу немедленно. |
Настройки RStrace
Следующий пример иллюстрирует XML-структуру настроек RStrace. Значение параметра DefaultTraceSwitch определяет тип информации, добавляемой в журнал. За исключением атрибута Components, значения для настройки RStrace одни и те же в разных файлах конфигурации. Атрибут Components обладает другим набором допустимых значений для файла Web.config сервера отчетов. Таблица в этом разделе объясняет допустимые значения этого атрибута.
<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="debugwindow, 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 |
Задает формируемое значение, позволяющее отличить один экземпляр журнала от другого. По умолчанию к именам файлов журнала трассировки добавляются значения timestamp. Значение этой величины — «tid, time». Не изменяйте этот параметр. |
TraceListeners |
Задает, куда будет выводиться содержимое журнала трассировки. Можно через запятую задать несколько расположений. Допустимые значения: DebugWindow (по умолчанию) File (по умолчанию) StdOut |
TraceFileMode |
Определяет, содержат ли журналы трассировки данные за 24-часовой период. Необходимо, чтобы каждому компоненту за каждый день соответствовал один уникальный журнал трассировки. Значение этой величины — Unique (по умолчанию). Не изменяйте это значение. |
Components |
Указывает компоненты, для которых формируется информация журнала трассировки и уровень трассировки. Допустимые значения зависят от файла конфигурации. В файлах ReportServerService.exe.config и Web.config для диспетчера отчетов: по умолчанию устанавливается значение all. Другими допустимыми значениями этого параметра являются названия внутренних компонентов. Не меняйте это значение в данных файлах конфигурации. В файле Web.config для сервера отчетов: по умолчанию устанавливается значение «all,RunningJobs:3,SemanticQueryEngine:2,SemanticModelGenerator:2». Допустимые значения для параметра Components в этом файле Web.config включают список компонентов, разделенных запятой, и уровень трассировки для каждого компонента; при этом 0 = отмена трассировки, 1 = исключения и перезапуски, 2 = исключения, перезапуски, предупреждения, 3 = исключения, перезапуски, предупреждения, сообщения о состоянии (по умолчанию), 4 = подробная информация.
Можно указать все или некоторые компоненты (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 базы знаний на веб-узле Майкрософт.
См. также
Основные понятия
Файлы журнала служб Reporting Services
Другие ресурсы
Ошибки и события служб Reporting Services
Устранение неполадок в службах Reporting Services