Reporting Services 追蹤記錄

發行項
12/15/2008

追蹤記錄包含關於報表伺服器作業的詳細資訊。追蹤記錄包括已記錄於其他記錄檔的重複資訊，加上別處所沒有的其他資訊。追蹤記錄適用於偵錯涉及報表伺服器的應用程式，或者調查寫入事件記錄或執行記錄的特定問題。

追蹤記錄每天建立，開始於午夜後 (當地時間) 發生的第一筆項目。追蹤記錄檔名稱衍生自電腦的本地時間。依預設，追蹤記錄的上限為 32 MB，並且會在 14 天之後遭到刪除。

尋找追蹤記錄

SQL Server Reporting Services 提供四個追蹤記錄檔，位於 \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles。分別描述於下表中。

記錄檔名稱	描述
ReportServerService_<timestamp>.log	報表伺服器 Windows 服務工作者執行緒的追蹤記錄。
ReportServerService_main_<timestamp>.log	報表伺服器 Windows 服務管理執行緒的追蹤記錄。
ReportServerWebApp_<timestamp>.log	報表管理員的追蹤記錄。
ReportServer_<timestamp>.log	報表伺服器 Web 服務的追蹤記錄。

檢視記錄資訊

追蹤記錄均為文字檔。您可以使用任何文字編輯器檢視記錄。在追蹤記錄中可以找到下列資訊：

系統資訊，包括作業系統、版本、處理器數量及記憶體。
Reporting Services 元件和版本資訊。
應用程式記錄檔的事件記錄。
報表伺服器所產生的例外狀況。
報表伺服器所記錄的低資源警示。
輸入 SOAP Envelope 和摘要輸出 SOAP Envelope。
HTTP 標頭、堆疊追蹤和偵錯追蹤資訊。

您可以檢閱追蹤記錄，以判斷是否發生報表傳遞、誰接收到報表以及嘗試傳遞了幾次。追蹤記錄也會記錄報表執行活動，以及報表處理期間有作用的環境變數。錯誤和例外狀況也會輸入到追蹤記錄中。例如，您可以找到報表逾時錯誤 (以 ThreadAbortExceptions 項目表示)。

設定追蹤層級

追蹤層級可透過 DefaultTraceSwitch 和 RSTrace 設定來指定。每一個元件會以不同的組態檔來儲存追蹤層級設定。若要控制每一個記錄檔所儲存的資訊量，您必須在正確的組態檔中修改設定。

元件記錄檔名稱	包含追蹤設定的組態檔
ReportServerService_<timestamp>.log 和 ReportServerService_main_<timestamp>.log	ReportingServicesService.config 檔。如需詳細資訊，請參閱＜ReportingServicesService 組態檔＞。您必須重新啟動 Windows 服務，組態檔的變更才會生效。
ReportServerWebApp_<timestamp>.log	報表管理員的 Web.config 檔，位於 Program Files\SQL Server\MSSQL.n\Reporting Services\ReportManager 資料夾。組態檔的變更會立即生效。
ReportServer_<timestamp>.log	報表伺服器 Web 服務的 Web.config 檔，位於 Program Files\SQL Server\MSSQL.n\Reporting Services\ReportServer 資料夾。組態檔的變更會立即生效。

ReportServerService_<timestamp>.log 和 ReportServerService_main_<timestamp>.log

ReportingServicesService.config 檔。

如需詳細資訊，請參閱＜ReportingServicesService 組態檔＞。

您必須重新啟動 Windows 服務，組態檔的變更才會生效。

ReportServerWebApp_<timestamp>.log

報表管理員的 Web.config 檔，位於 Program Files\SQL Server\MSSQL.n\Reporting Services\ReportManager 資料夾。

組態檔的變更會立即生效。

ReportServer_<timestamp>.log

報表伺服器 Web 服務的 Web.config 檔，位於 Program Files\SQL Server\MSSQL.n\Reporting Services\ReportServer 資料夾。

組態檔的變更會立即生效。

RStrace 設定

下列範例說明 RStrace 設定的 XML 結構。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	指定追蹤記錄的大小上限。檔案大小的單位為 MB。有效值為 0 到最大整數。預設值為 32。如果指定 0 或負數，報表伺服器會將該值視為 1。
KeepFilesForDays	指定一個天數，超過此天數後，追蹤記錄檔便會被刪除。有效值為 0 到最大整數。預設值為 14。如果指定 0 或負數，報表伺服器會將該值視為 1。
Prefix	指定可區別記錄檔執行個體的產生值。依預設，會將時間戳記附加至追蹤記錄檔名稱。此值設定為 "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"。在這個 Web.config 檔中，Components 的有效值包含以逗號分隔的元件清單，以及每個元件的追蹤層級，其中 0=停用追蹤、1=例外狀況和重新啟動、2=例外、重新啟動和警告、3=例外、重新啟動、警告和狀態訊息 (預設值)、4=詳細資訊。 All 用來針對所有不屬於特定類別的程序，追蹤其一般報表伺服器活動。 RunningJobs 用來追蹤進行中報表或訂閱作業。 SemanticQueryEngine 用來追蹤語意查詢，語意查詢會在使用者對以模型為基礎的報表執行特定資料瀏覽時處理。 SemanticModelGenerator 用來追蹤模型產生。您可以指定全部或部分元件 (all、RunningJobs、SemanticQueryEngine、SemanticModelGenerator)。如果不要產生特定元件的資訊，可以停用該元件的追蹤 (例如 "SemanticModelGenerator:0")。請不要停用 all 的追蹤。如果沒有在元件後面附加追蹤層級，會使用在 DefaultTraceSwitch 指定的值。例如，如果指定 "all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator"，所有元件都會使用預設追蹤層級。如果要檢視為每個語意查詢產生的 Transact-SQL 陳述式，您可以設定 "SemanticQueryEngine:4"。Transact-SQL 陳述式就會記錄在追蹤記錄中。下列範例說明將 Transact-SQL 陳述式加入記錄的組態設定： <add name="Components" value="all,SemanticQueryEngine:4" />

新增自訂組態設定來指定傾印檔位置

您可以新增自訂設定，來設定 Windows 的 Dr. Watson 工具用來儲存傾印檔的位置。自訂設定為 Directory。下列範例說明如何在 RStrace 區段中指定這個組態設定：

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

如需詳細資訊，請參閱 Microsoft 網站上的 913046 號知識庫文件 (英文)。

請參閱

共用方式為