Журнал трассировки службы сервера отчетов

Журнал трассировки сервера отчетов содержит подробнейшие сведения об операциях службы сервера отчетов, включая операции, выполняемые веб-службой сервера отчетов, диспетчером отчетов и приложением фоновой обработки. Файл журнала трассировки содержит избыточные сведения, которые записываются в другие файлы журналов, а также дополнительные сведения, недоступные иным способом. Данные журнала трассировки могут оказаться полезными при отладке приложения, содержащего сервер отчетов, либо при изучении конкретной проблемы, зафиксированной в журнале событий или журнале выполнения.

ПримечаниеПримечание

В предыдущих версиях имелось несколько журналов трассировки, по одному на каждое приложение. В этом выпуске все данные журналов объединены в один файл. Следующие файлы устарели и больше не создаются в 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

Указывает компоненты, для которых формируется информация журнала трассировки, и уровень трассировки в следующем формате:

<категория_компонента>:<уровень_трассировки>

Категории компонентов можно установить следующим образом.

  • Параметр All используется для трассировки общей активности сервера отчетов для всех процессов, которые не разбиваются на конкретные категории.

  • Параметр RunningJobs применяется для трассировки формирования отчета или операции подписки.

  • Параметр SemanticQueryEngine используется для трассировки семантических запросов, которые обрабатываются, когда пользователь проводит нерегламентированный просмотр данных отчета на основе моделей.

  • Параметр SemanticModelGenerator применяется для трассировки формирования модели.

  • Параметр http используется для включения файла журнала HTTP сервера отчетов. Дополнительные сведения см. в разделе Журнал HTTP-запросов сервера отчетов.

Допустимыми значениями уровня трассировки являются следующие.

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 базы знаний на сайте Майкрософт.