• 發行項

報表伺服器服務追蹤記錄

報表伺服器追蹤記錄包含報表伺服器服務作業的詳細資訊，包括報表伺服器 Web 服務、報表管理員和背景處理所執行的作業。追蹤記錄檔包括已記錄於其他記錄檔的重複資訊，加上別處所沒有的其他資訊。如果您要偵錯包含報表伺服器的應用程式，或者調查寫入事件記錄或執行記錄的特定問題，追蹤記錄資訊可能會很有用。

[!附註]

在先前的版本中，系統提供了多個追蹤記錄檔 (每個應用程式都有一個檔案)。這個版本則將所有記錄資料合併至單一檔案中。下列檔案已經過時，而且在 SQL Server 2008 中不會再建立：ReportServerWebApp_<timestamp>.log、ReportServer_<timestamp>.log 和 ReportServerService_main_<timestamp>.log。

檢視記錄資訊

追蹤記錄檔為 ReportServerService_<timestamp>.log。追蹤記錄是 ASCII 文字檔。您可以使用任何文字編輯器來檢視此檔案。這個檔案位於 \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles。系統每天都會建立追蹤記錄，從午夜過後 (當地時間) 發生的第一個項目，以及每次服務重新啟動時開始。此時間戳記是以國際標準時間 (UTC) 為基礎。此檔案採用 EN-US 格式。依預設，追蹤記錄的上限為 32 MB，並且會在 14 天之後遭到刪除。

ReportServerService 記錄檔的組態設定

追蹤層級可透過 DefaultTraceSwitch 和 RSTrace 設定來指定。所有追蹤層級設定都會儲存在 ReportingServicesrService.exe.config 檔中。

此組態檔是在資料路徑：\Program Files\Microsoft SQL Server\MSRS10_50.<執行個體名稱>\Reporting Services\ReportServer\bin 中。

ReportServerService 記錄檔是預設為啟用。

若要關閉，請在 ReportingServicesService.exe.config 檔的 RStrace 區段中，將追蹤層級設定為 0。

若要限制這些檔案的保留天數，請在 RStrace 區段中指定 KeepFilesForDays 組態設定。這個值預設為 14。

若要限制檔案大小，請在 RStrace 區段中指定 FileSizeLimitMb 組態設定。根據預設，此值設定為 32 MB。藉由設定追蹤層級 (0 到 4) 來控制記錄的內容多寡，便可以控制檔案大小。您也可以指定要追蹤的元件。如果在 14 天的到期日之前就已經到達記錄檔上限，將會以較新的項目取代較舊的項目。

記錄檔欄位

您可以在追蹤記錄中找到下列欄位：

  • 系統資訊，包括作業系統、版本、處理器數量及記憶體。

  • Reporting Services 元件和版本資訊。

  • 應用程式記錄檔的事件記錄。

  • 報表伺服器所產生的例外狀況。

  • 報表伺服器所記錄的低資源警示。

  • 輸入 SOAP Envelope 和摘要輸出 SOAP Envelope。

  • HTTP 標頭、堆疊追蹤和偵錯追蹤資訊。

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

範例組態設定

下列範例說明 RStrace 設定的 XML 結構。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

指定追蹤記錄的大小上限。檔案大小的單位為 MB。有效值為 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"，所有元件都會使用預設追蹤層級。

如果要檢視為每個語意查詢產生的 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。