Berichtsserverdienstablauf-Verfolgungsprotokoll

Das Berichtsserver-Ablaufverfolgungsprotokoll enthält sehr detaillierte Informationen für Berichtsserver-Dienstvorgänge, einschließlich vom Report Server-Webdienst, vom Berichts-Manager und von der Hintergrundverarbeitung ausgeführte Vorgänge. In den Ablaufverfolgungsprotokollen sind redundante Informationen gespeichert, die in anderen Protokolldateien aufgezeichnet werden, sowie zusätzliche Informationen, die anderweitig nicht verfügbar sind. Ablaufverfolgungsinformationen können beispielsweise zum Debuggen einer Anwendung, die einen Berichtsserver enthält, oder zum Analysieren eines bestimmten Problems, das ins Ereignis- oder Ausführungsprotokoll geschrieben wurde, nützlich sein.

HinweisHinweis

In vorherigen Versionen waren mehrere Ablaufverfolgungsprotokolldateien vorhanden, eine pro Anwendung. In dieser Version wurden alle Protokolldaten in eine einzelne Datei konsolidiert. Die folgenden Dateien sind veraltet und werden nicht mehr in SQL Server 2008 erstellt: ReportServerWebApp_<Timestamp>.log, ReportServer_<Timestamp>.log und ReportServerService_main_<Timestamp>.log.

Anzeigen von Protokollinformationen

Die Ablaufverfolgungsprotokolldatei ist ReportServerService_<Timestamp>.log. Das Ablaufverfolgungsprotokoll ist eine ASCII-Textdatei. Sie können die Datei mithilfe eines Text-Editors anzeigen. Diese Datei befindet sich unter \Microsoft SQL Server\<SQL Server-Instanz>\Reporting Services\LogFiles. Das Ablaufverfolgungsprotokoll wird täglich erstellt, beginnend mit dem ersten Eintrag nach Mitternacht (lokale Zeit) sowie nach Neustart des Diensts. Der Timestamp basiert auf der koordinierten Weltzeit (UTC). Die Datei liegt im Format EN-US vor. Standardmäßig sind Ablaufverfolgungsprotokolle auf 32 Megabyte begrenzt und werden nach 14 Tagen gelöscht.

Konfigurationseinstellungen für die ReportServerService-Protokolldatei

Ablaufverfolgungsebenen werden mithilfe der Einstellungen DefaultTraceSwitch und RSTrace angegeben. Alle Ablaufverfolgungsebenen-Einstellungen werden in der Datei ReportingServicesService.exe.config gespeichert.

Die Konfigurationsdatei befindet sich im Ordner \Programme\Microsoft SQL Server\MSRS10.<Instanzname>\Reporting Services\ReportServer\bin.

Das ReportServerService-Protokoll ist standardmäßig aktiviert.

Zur Deaktivierung legen Sie für die Ablaufverfolgungsebene im Abschnitt RStrace der Datei ReportingServicesService.exe.config den Wert 0 (Null) fest.

Zur Begrenzung der Anzahl der Tage, die die Dateien aufbewahrt werden, legen Sie die Konfigurationseinstellung KeepFilesForDays im Abschnitt RStrace fest. Standardmäßig ist dieser Wert auf 14 festgelegt.

Zur Begrenzung der Dateigröße geben Sie die FileSizeLimitMb-Konfigurationseinstellung im Abschnitt RStrace an. Dieser Wert ist standardmäßig auf 32 Megabytes festgelegt. Sie können die Dateigröße beeinflussen, indem Sie Ablaufverfolgungsebenen festlegen (0 bis 4), um zu steuern, wie viel Inhalt aufgezeichnet wird. Zudem können Sie angeben, welche Bestandteile verfolgt werden. Wenn das Maximum der Protokolldatei vor dem Ablaufdatum von 14 Tagen erreicht wird, werden ältere Einträge durch neuere Einträge ersetzt.

Protokolldateifelder

Ein Ablaufverfolgungsprotokoll enthält folgende Felder:

  • Systeminformationen, einschließlich Betriebssystem, Version, Anzahl der Prozessoren und Arbeitsspeicher.

  • Reporting Services-Komponente und Versionsinformationen.

  • Im Anwendungsprotokoll protokollierte Ereignisse.

  • Vom Berichtsserver generierte Ausnahmen.

  • Von einem Berichtsserver protokollierte Warnungen wegen unzureichender Ressourcen.

  • Eingehende SOAP-Umschläge und zusammengefasste ausgehende SOAP-Umschläge.

  • Informationen zu HTTP-Header, Stapelüberwachung und Debugablaufverfolgung.

Sie können anhand der Informationen im Ablaufverfolgungsprotokoll bestimmen, ob ein Bericht übermittelt wurde, wer den Bericht empfangen hat und wie viele Übermittlungsversuche unternommen wurden. Ablaufverfolgungsprotokolle zeichnen auch Berichtsausführungsaktivitäten sowie die Umgebungsvariablen auf, die bei der Berichtsverarbeitung verwendet werden. Fehler und Ausnahmen werden ebenfalls in Ablaufverfolgungsprotokollen aufgezeichnet. Dazu zählen beispielsweise Berichtstimeoutfehler (erkennbar am ThreadAbortExceptions-Eintrag).

Beispiel für Konfigurationseinstellungen

Im folgenden Beispiel wird die XML-Struktur der RStrace-Einstellungen veranschaulicht. Der Wert für DefaultTraceSwitch bestimmt die Art der Informationen, die dem Protokoll hinzugefügt werden. Mit Ausnahme des Components-Attributs sind die Werte für RStrace in den Konfigurationsdateien identisch.

  <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>

Die folgende Tabelle enthält Informationen zu den einzelnen Einstellungen.

Einstellung

Beschreibung

RStrace

Gibt Namespaces an, die für Fehler und für die Ablaufverfolgung verwendet werden.

DefaultTraceSwitch

Gibt die Ebene der Informationen an, die im Ablaufverfolgungsprotokoll ReportServerService aufgezeichnet werden. Jede Ebene enthält jeweils die Informationen aller niedrigeren Ebenen. Das Deaktivieren der Ablaufverfolgung wird nicht empfohlen. Gültige Werte sind:

0= Deaktiviert die Ablaufverfolgung

1= Ausnahmen und Neustarts

2= Ausnahmen, Neustarts, Warnungen

3= Ausnahmen, Neustarts, Warnungen, Statusmeldungen (Standard)

4= Ausführlicher Modus

FileName

Gibt den ersten Teil des Protokolldateinamens an. Der Wert von Prefix ergänzt den restlichen Namen.

FileSizeLimitMb

Gibt eine Obergrenze für die Größe des Ablaufverfolgungsprotokolls an. Die Dateigröße wird in Megabytes gemessen. Gültige Werte sind 0 bis zu einer maximalen ganzen Zahl. Der Standardwert ist 32. Wenn Sie 0 (Null) oder eine negative Zahl angeben, wird dieser Wert vom Berichtsserver wie der Wert 1 behandelt.

KeepFilesForDays

Gibt die Anzahl von Tagen an, nach der eine Ablaufverfolgungs-Protokolldatei gelöscht wird. Gültige Werte sind 0 bis zu einer maximalen ganzen Zahl. Der Standardwert ist 14. Wenn Sie 0 (Null) oder eine negative Zahl angeben, wird dieser Wert vom Berichtsserver wie der Wert 1 behandelt.

Prefix

Gibt einen generierten Wert an, der die Protokollinstanzen voneinander unterscheidet. Standardmäßig werden Timestampwerte an die Dateinamen von Ablaufverfolgungsprotokollen angehängt. Dieser Wert wird auf "tid, time " festgelegt. Ändern Sie diese Einstellung nicht.

TraceListeners

Gibt die Zieladresse für die Ausgabe des Inhalts von Ablaufverfolgungsprotokollen an. Sie können mehrere durch Trennzeichen getrennte Ziele angeben. Gültige Werte sind:

DebugWindow

File (Standard)

StdOut

TraceFileMode

Gibt an, ob Ablaufverfolgungsprotokolle Daten für einen Zeitraum von 24 Stunden enthalten. Für jede Komponente sollte pro Tag ein eindeutiges Ablaufverfolgungsprotokoll erstellt werden. Dieser Wert wird auf "Unique (Standard)" festgelegt. Ändern Sie diesen Wert nicht.

Components

Gibt die Komponenten, für die Ablaufverfolgungsprotokoll-Informationen generiert werden, sowie die Ablaufverfolgungsebene in diesem Format an:

<Komponentenkategorie>:<tracelevel>

Für Komponentenkategorien kann Folgendes festgelegt werden:

  • All wird zur Ablaufverfolgung der allgemeinen Berichtsserveraktivität für alle Vorgänge verwendet, die nicht in die einzelnen Kategorien unterteilt werden.

  • RunningJobs wird für die Ablaufverfolgung eines ausgeführten Berichts oder eines Abonnementvorgangs verwendet.

  • SemanticQueryEngine wird für die Ablaufverfolgung einer Semantikabfrage verwendet, die verarbeitet wird, wenn ein Benutzer eine Ad-hoc-Durchsuchung von Daten in einem modellbasierten Bericht ausführt.

  • SemanticModelGenerator wird für die Ablaufverfolgung der Modellgenerierung verwendet.

  • http wird verwendet, um die Berichtsserver-HTTP-Protokolldatei zu aktivieren. Weitere Informationen finden Sie unter Berichtsserver-HTTP-Protokoll.

Gültige Werte für die Ablaufverfolgungsebene sind Folgende:

0= Deaktiviert die Ablaufverfolgung

1= Ausnahmen und Neustarts

2= Ausnahmen, Neustarts, Warnungen

3= Ausnahmen, Neustarts, Warnungen, Statusmeldungen (Standard)

4= Ausführlicher Modus

Der Standardwert für Berichtsserver ist: "all:3".

Sie können alle oder einige der Komponenten angeben (all, RunningJobs, SemanticQueryEngine und SemanticModelGenerator). Wenn Informationen für eine bestimmte Komponente nicht generiert werden sollen, können Sie deren Ablaufverfolgung deaktivieren (z. B. "SemanticModelGenerator:0"). Deaktivieren Sie nicht die Ablaufverfolgung für all.

Wenn Sie keine Ablaufverfolgungsebene an die Komponente anfügen, wird der für DefaultTraceSwitch angegebene Wert verwendet. Wenn Sie beispielsweise "all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator" angeben, verwenden alle Komponenten die Standard-Ablaufverfolgungsebene.

Sie können "SemanticQueryEngine:4" festlegen, wenn Sie die für jede Semantikabfrage generierten Transact-SQL-Anweisungen anzeigen möchten. Die Transact-SQL-Anweisungen werden im Ablaufverfolgungsprotokoll aufgezeichnet. Im folgenden Beispiel wird die Konfigurationseinstellung veranschaulicht, die dem Protokoll Transact-SQL-Anweisungen hinzufügt:

<add name="Components" value="all,SemanticQueryEngine:4" />

Hinzufügen einer benutzerdefinierten Konfigurationseinstellung zum Angeben eines Orts für eine Sicherungsdatei

Sie können dem Ort, der vom Windows-Tool Dr. Watson zum Speichern von Sicherungsdateien verwendet wird, eine benutzerdefinierte Einstellung hinzufügen. Die benutzerdefinierte Einstellung ist Directory. Im folgenden Beispiel wird veranschaulicht, wie diese Konfigurationseinstellung im Abschnitt RStrace angegeben wird:

<add name="Directory" value="U:\logs\" />

Weitere Informationen finden Sie im Knowledge Base-Artikel 913046 auf der Microsoft-Website.