報表伺服器 HTTP 記錄

報表伺服器 HTTP 記錄檔會保留報表伺服器所處理之每個 HTTP 要求與回應的記錄。由於要求溢位和逾時錯誤不會送達報表伺服器,因此它們不會記錄在記錄檔中。

HTTP 記錄預設是不啟用的。您必須修改 ReportServerService.exe 組態檔,才能在安裝中使用這項功能。

檢視記錄資訊

此記錄是 ASCII 文字檔。您可以使用任何文字編輯器來檢視此檔案。報表伺服器 HTTP 記錄檔相當於 IIS 中的 W3C 記錄擴充檔而且使用類似的欄位,因此您可以使用現有的 IIS 記錄檔檢視器來讀取報表伺服器 HTTP 記錄檔。下表提供有關 HTTP 記錄檔的其他資訊:

檔案名稱

根據預設,其檔案名稱為 ReportServerService_HTTP_<timestamp>.log。您可以透過在 ReportServerService.exe.config 檔中修改 HttpTraceFileName 屬性,自訂檔案名稱的前置詞。此時間戳記是以國際標準時間 (UTC) 為基礎。

檔案位置

此檔案位於 \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles。

檔案格式

此檔案採用 EN-US 格式。它是 ASCII 文字檔。

檔案建立和保留

當您在組態檔中啟用 HTTP 記錄、重新啟動此服務,然後報表伺服器處理 HTTP 要求之後,系統就會建立 HTTP 記錄。如果您設定了這些設定,但卻沒有看見記錄檔,請開啟報表或啟動報表伺服器應用程式 (例如「報表管理員」) 來產生 HTTP 要求,以便建立此檔案。

記錄檔的新執行個體會在報表伺服器的每個服務重新啟動和後續 HTTP 要求之後建立。

根據預設,追蹤記錄的上限為 32 MB,並且會在 14 天之後遭到刪除。

設定報表伺服器 HTTP 記錄的設定

若要設定報表伺服器 HTTP 記錄,請使用 [記事本] 來修改 ReportServerService.exe.config 檔。此組態檔位於 \Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin 資料夾中。

若要啟用 HTTP 伺服器,您必須將 http:4 加入至 ReportServerService.exe.config 檔的 RStrace 區段。所有其他 HTTP 記錄檔項目是選擇性的。下列範例包含所有設定,因此您可以將整個區段貼入 RStrace 區段,然後刪除不需要的設定。

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

記錄檔欄位

下表將描述記錄中提供的欄位。此欄位清單是可設定的。您可以透過 HTTPTraceSwitches 組態設定,指定要包含的欄位。預設資料行會指定此欄位是否自動包含在記錄檔中 (如果您沒有指定 HTTPTraceSwitches 的話)。

欄位

描述

預設

HttpTraceFileName

這是選擇性的值。預設值為 ReportServerServiceHTTP_。如果您想要使用不同的檔案命名慣例 (例如,當您要將記錄檔儲存至集中位置時,若要包含伺服器名稱),可以指定不同的值。

是

HttpTraceSwitches

這是選擇性的值。如果您指定了此欄位,就可以使用逗號分隔的格式來設定記錄檔中使用的欄位。

否

Date

活動發生的日期。

否

Time

活動發生的時間。

否

ClientIp

存取報表伺服器之用戶端的 IP 位址。

是

UserName

存取報表伺服器之使用者的名稱。

否

ServerPort

用於連接的通訊埠編號。

否

Host

主機標頭的內容。

否

Method

從用戶端呼叫的動作或 SOAP 方法。

是

UriStem

存取的資源。

是

UriQuery

用來存取資源的查詢。

否

ProtocolStatus

HTTP 狀態碼。

是

BytesReceived

伺服器所接收的位元組數目。

否

TimeTaken

從 HTTP.SYS 傳回要求資料的那一刻,直到伺服器完成最後一個傳送作業為止的時間 (以毫秒為單位),但不包括網路傳輸時間。

否

ProtocolVersion

用戶端所使用的通訊協定版本。

否

UserAgent

用戶端所使用的瀏覽器類型。

否

CookieReceived

伺服器所接收的 Cookie 內容。

否

CookieSent

伺服器所傳送的 Cookie 內容。

否

Referrer

用戶端造訪的上一個網站。

否