Berichtsserver-HTTP-Protokoll
Die HTTP-Protokolldatei des Berichtsservers zeichnet alle HTTP-Anforderungen und -Antworten auf, die vom Berichtsserver verarbeitet werden. Da Anforderungsüberlauf- und Timeoutfehler den Berichtsserver nicht erreichen, werden sie nicht in der Protokolldatei aufgezeichnet.
Die HTTP-Protokollierung ist standardmäßig nicht aktiviert. Sie müssen die Konfigurationsdatei ReportServerService.exe bearbeiten, um diese Funktion in der Installation verwenden zu können.
Anzeigen von Protokollinformationen
Das Protokoll ist eine ASCII-Textdatei. Sie können die Datei mithilfe eines Text-Editors anzeigen. Die Berichtsserver-HTTP-Protokolldatei ist identisch mit der erweiterten W3C-Protokolldatei in IIS und verwendet ähnliche Felder, sodass Sie vorhandene IIS-Protokolldatei-Viewer zum Lesen der Berichtsserver-HTTP-Protokolldatei verwenden können. Die folgende Tabelle enthält weitere Informationen über die HTTP-Protokolldatei:
Dateiname |
Standardmäßig lautet der Dateiname ReportServerService_HTTP_<Timestamp>.log. Sie können das Präfix des Dateinamens anpassen, indem Sie das Attribut HttpTraceFileName in der Datei ReportServerService.exe.config ändern. Der Timestamp basiert auf der koordinierten Weltzeit (UTC). |
Dateispeicherort |
Die Datei befindet sich unter \Microsoft SQL Server\<SQL Server-Instanz>\Reporting Services\LogFiles. |
Dateiformat |
Die Datei liegt im Format EN-US vor. Es handelt sich um eine ASCII-Textdatei. |
Dateierstellung und -beibehaltung |
Das HTTP-Protokoll wird erstellt, nachdem Sie es in der Konfigurationsdatei aktiviert und den Dienst neu gestartet haben und der Berichtsserver eine HTTP-Anforderung verarbeitet hat. Wenn Sie die Einstellungen konfiguriert haben, die Protokolldatei jedoch nicht sehen können, öffnen Sie einen Bericht, oder starten Sie eine Berichtsserveranwendung (wie den Berichts-Manager), um eine HTTP-Anforderung zum Erstellen der Datei zu generieren. Es wird ein neues Exemplar der Protokolldatei nach jedem Neustart des Diensts und einer nachfolgenden HTTP-Anforderung an den Berichtsserver erstellt. Standardmäßig sind Ablaufverfolgungsprotokolle auf 32 Megabyte begrenzt und werden nach 14 Tagen gelöscht. |
Konfigurationseinstellungen für das Berichtsserver-HTTP-Protokoll
Konfigurieren Sie das Berichtsserver-HTTP-Protokoll, indem Sie mit dem Editor die Datei ReportServerService.exe.config ändern. Die Konfigurationsdatei befindet sich im Ordner \Programme\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin.
Um den HTTP-Server zu aktivieren, müssen Sie dem Abschnitt RStrace der Datei ReportServerService.exe.config http:4 hinzufügen. Alle anderen HTTP-Protokolldateieinträge sind optional. Das folgende Beispiel umfasst alle Einstellungen, sodass Sie den gesamten Abschnitt über den Abschnitt RStrace kopieren und dann die nicht benötigten Einstellungen löschen können.
<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="HttpTraceFileName" value="ReportServerService_HTTP_" />
<add name="HttpTraceSwitches" value="date,time, clientip,username,serverip,serverport,host,method,uristem,uriquery,protocolstatus,bytesreceived,timetaken,protocolversion,useragent,cookiereceived,cookiesent,referrer" />
<add name="Components" value="all:3,http:4" />
</RStrace>
Protokolldateifelder
In der folgenden Tabelle sind die im Protokoll verfügbaren Felder beschrieben. Die Feldliste kann konfiguriert werden; Sie können mit der HTTPTraceSwitches-Konfigurationseinstellung angeben, welche Felder einbezogen werden sollen. Die Spalte Standard gibt an, ob das Feld automatisch in die Protokolldatei aufgenommen wird, wenn Sie HTTPTraceSwitches nicht festlegen.
Feld |
Beschreibung |
Standard |
|---|---|---|
HttpTraceFileName |
Dieser Wert ist optional. Der Standardwert ist ReportServerServiceHTTP_. Sie können einen anderen Wert angeben, wenn Sie eine andere Dateinamenkonvention verwenden möchten. (Sie können zum Beispiel den Servernamen einbeziehen, wenn Protokolldateien zentral gespeichert werden). |
Ja |
HttpTraceSwitches |
Dieser Wert ist optional. Wenn Sie diesen Wert angeben, können Sie die in der Protokolldatei verwendeten Felder im durch Trennzeichen getrennten Format konfigurieren. |
Nein |
Date |
Das Datum des Auftretens der Aktivität. |
Nein |
Time |
Die Uhrzeit des Auftretens der Aktivität. |
Nein |
ClientIp |
Die IP-Adresse des Clients, der auf den Berichtsserver zugreift. |
Ja |
UserName |
Der Name des Benutzers, der auf den Berichtsserver zugreift. |
Nein |
ServerPort |
Die für die Verbindung verwendete Portnummer. |
Nein |
Host |
Der Inhalt des Hostheaders. |
Nein |
Methode |
Die Aktion oder SOAP-Methode, die vom Client aufgerufen wird. |
Ja |
UriStem |
Die Ressource, auf die zugegriffen wird. |
Ja |
UriQuery |
Die Abfrage, mit der auf die Ressource zugegriffen wird. |
Nein |
ProtocolStatus |
Der HTTP-Statuscode. |
Ja |
BytesReceived |
Die Anzahl der vom Server empfangenen Byte. |
Nein |
TimeTaken |
Die Zeit (in Millisekunden) von der Rückgabe der Anforderungsdaten durch HTTP.SYS bis zum Verarbeitungsende der letzten Sendung durch den Server ohne die Netzwerk-Übertragungszeit. |
Nein |
ProtocolVersion |
Die vom Client verwendete Protokollversion. |
Nein |
UserAgent |
Der vom Client verwendete Browsertyp. |
Nein |
CookieReceived |
Der Inhalt des vom Server empfangenen Cookies. |
Nein |
CookieSent |
Der Inhalt des vom Server gesendeten Cookies. |
Nein |
Referrer |
Die vorherige vom Client aufgerufene Website. |
Nein |