Поделиться через


Журналы трассировки служб 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 применяется для трассировки формирования модели.

Можно указать все или некоторые компоненты (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

Справка и поддержка

Получение помощи по SQL Server 2005