設定追蹤

本主題將說明如何啟用追蹤、設定追蹤來源以發出追蹤並設定追蹤層級、設定活動追蹤與傳播以支援端對端追蹤相互關聯，以及設定追蹤接聽項來存取追蹤。

如需在生產與偵錯環境中的追蹤設定建議，請參閱追蹤與訊息記錄的建議設定。

啟用追蹤

Windows Communication Foundation (WCF) 會輸出下列資料來進行診斷追蹤：

• 所有應用程式元件的處理過程里程碑追蹤，例如作業呼叫、程式碼例外狀況、警告和其他重大處理事件。
• 追蹤功能故障時出現的 Windows 錯誤事件。請參閱事件記錄。

WCF 追蹤是建立在 System.Diagnostics 之上。若要使用追蹤，您應該透過組態檔或程式碼來定義追蹤來源。WCF 會為每個 WCF 組件定義追蹤來源。System.ServiceModel 追蹤來源是最普遍的 WCF 追蹤來源，可記錄從進入/離開傳輸到進入/離開使用者程式碼的整個 WCF 通訊堆疊的處理里程碑。System.ServiceModel.MessageLogging 追蹤來源會記錄在系統之間來回傳送的所有訊息。

預設不會啟用追蹤。若要啟動追蹤，您必須建立追蹤接聽項並針對組態中的選取追蹤來源，將追蹤層級設為「關閉」以外的層級，否則，WCF 將不會產生任何追蹤。如果您沒有指定接聽項，就會自動停用追蹤。如果已定義接聽項，但是未指定層級，則預設會將層級設定為「關閉」，這表示將不會發出任何追蹤。

您可以透過應用程式的組態檔 (Web 主控應用程式的 Web.config，或自我裝載應用程式的 Appname.exe.config) 來設定追蹤。範例如下。

<configuration>
   <system.diagnostics>
      <sources>
            <source name="System.ServiceModel" 
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="traceListener" 
                   type="System.Diagnostics.XmlWriterTraceListener" 
                   initializeData= "c:\log\Traces.svclog" />
            </listeners>
         </source>
      </sources>
   </system.diagnostics>
</configuration>

注意：
若要在 Visual Studio 中編輯 WCF 服務專案的組態檔，請以滑鼠右鍵按一下 [方案總管] 中的此服務專案，然後選擇 [編輯 WCF 組態] 內容功能表項目。這會啟動Configuration Editor Tool (SvcConfigEditor.exe)，讓您使用圖形使用者介面修改 WCF 服務的組態設定。

設定追蹤來源來發出追蹤

WCF 會為每個組件定義追蹤來源。組件中產生的追蹤是由針對該來源而定義的接聽項所存取。下列為定義的追蹤來源：

• System.ServiceModel：記錄 WCF 處理的所有階段，不管是讀取組態、在傳輸過程中處理訊息、安全性處理、透過使用者程式碼來分派訊息等等。
• System.ServiceModel.MessageLogging：記錄在整個系統來回傳送的所有訊息。
• System.IdentityModel。
• System.ServiceModel.Activation。
• System.IO.Log：記錄一般記錄檔系統 (CLFS) 的 .NET Framework 介面。
• System.Runtime.Serialization：記錄何時讀取或寫入物件。
• CardSpace。

您可以設定每個追蹤來源來使用相同 (共用) 的接聽項，如下列組態範例所示。

<configuration>
    <system.diagnostics>
        <sources>
            <source name="System.ServiceModel" 
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="CardSpace">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.IO.Log">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.Runtime.Serialization">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
            <source name="System.IdentityModel">
                <listeners>
                    <add name="xml" />
                </listeners>
            </source>
        </sources>

        <sharedListeners>
            <add name="xml"
                 type="System.Diagnostics.XmlWriterTraceListener"
                 initializeData="c:\log\Traces.svclog" />
        </sharedListeners>
    </system.diagnostics>
</configuration>

此外，您可以新增使用者定義的追蹤來源 (如下列範例所示範) 來發出使用者程式碼追蹤。

<system.diagnostics>
   <sources>
       <source name="UserTraceSource" switchValue="Warning, ActivityTracing" >
          <listeners>
              <add name="xml"
                 type="System.Diagnostics.XmlWriterTraceListener"
                 initializeData="C:\logs\UserTraces.svclog" />
          </listeners>
       </source>
   </sources>
   <trace autoflush="true" /> 
</system.diagnostics>

如需 建立使用者定義追蹤來源的詳細資訊，請參閱Extending Tracing。

設定追蹤接聽項來使用追蹤

在執行階段，WCF 會將追蹤資料輸送到負責處理資料的接聽項。WCF 會向 System.Diagnostics 提供幾項預先定義的接聽項，其格式與輸出時使用的格式不同。您也可以新增自訂接聽項型別。

您可以使用 add 來指定要使用的追蹤接聽項名稱與型別。在我們的組態範例中，我們將接聽項命名為 traceListener 並將標準 .NET Framework 追蹤接聽項 (System.Diagnostics.XmlWriterTraceListener) 當成要使用的型別加入。您可以為每一個來源新增任何數量的追蹤接聽項。如果追蹤接聽項將追蹤發出到檔案中，則您必須在組態檔中指定輸出檔案位置與名稱。您可以將 initializeData 設定為該接聽項的檔案名稱來完成。如果您沒有指定檔案名稱，就會根據使用的接聽項型別產生隨機檔案名稱。如果使用了 XmlWriterTraceListener，則會產生不含副檔名的檔名。如果您實作自訂接聽項，也可以同時使用此屬性來接收初始化資料 (而不是檔名)。例如，您可以為此屬性指定資料庫識別項。

您可以設定自訂追蹤接聽項，以將追蹤傳送到 Wire，例如傳送至遠端資料庫。身為應用程式的部署者，您應該在遠端電腦的追蹤記錄上強制執行適當的存取控制。

您也可以使用程式設計方式來設定追蹤接聽項。如需詳細資訊，請參閱 HOW TO：建立和初始設定追蹤接聽項 (本頁面可能為英文) 和建立自訂 TraceListener (本頁面可能為英文)。

注意：
因為 System.Diagnostics.XmlWriterTraceListener 不具備執行緒安全，追蹤來源可能會在輸出追蹤時特別鎖定資源。當許多執行緒將追蹤輸出至設定為使用此接聽項的追蹤來源時，可能會發生資源爭用的情況，進而造成顯著的效能問題。若要解決這個問題，您應該實作具備執行緒安全的自訂接聽項。

追蹤層級

追蹤層級是透過追蹤來源的 switchValue 設定來控制。下表描述可用的追蹤層級。

從「詳細資訊」到「嚴重」的層級會彼此交互堆疊，也就是說，每一個追蹤層級都會包含其上的所有層級 (除了「關閉」層級以外)。例如，在「警告」層級上接聽的接聽項會收到「嚴重」、「錯誤」以及「警告」追蹤。「全部」層級包含從「詳細資訊」到「嚴重」與「活動」追蹤事件的所有事件。

注意：
「資訊」、「詳細資訊」以及「ActivityTracing」層級會產生許多追蹤，如果您已經用完電腦上所有可用的資源，則這些追蹤可能會對訊息輸送量產生負面的影響。

設定活動追蹤與傳播來進行相互關聯

針對 switchValue 屬性而指定的 activityTracing 值可用來啟用活動追蹤，活動追蹤會為活動界限發出追蹤並在端點之間進行傳送。

注意：
當您使用 WCF 中的特定擴充功能時，如果活動追蹤已啟用，則您可能會取得 NullReferenceException。若要修正這個問題，請檢查您應用程式的組態檔，並確定追蹤來源的 switchValue 屬性不是設定為 activityTracing。

propagateActivity 屬性會指出是否應該將活動傳播至其他參與訊息交換的端點。將這個值設定為 true 之後，您就可以使用任意兩個端點所產生的追蹤檔，來觀察一個端點上的一組追蹤如何流動至另一個端點的一組追蹤。

如需 活動追蹤和傳播的詳細資訊，請參閱端對端追蹤相互關聯的活動追蹤與傳播。

propagateActivity 和 ActivityTracing 布林值都會套用至 System.ServiceModel TraceSource。 ActivityTracing 值也會套用至任何追蹤來源，包括 WCF 或使用者定義的追蹤來源。

您無法使用具有使用者定義追蹤來源的 propagateActivity 屬性。若要進行使用者程式碼活動識別碼傳播，請確定您未設定 ServiceModel ActivityTracing，而且讓 ServiceModel propagateActivity 屬性仍舊設定為 true。

請參閱

概念

管理與診斷

其他資源

追蹤
HOW TO：建立和初始設定追蹤接聽項
建立自訂 TraceListener