在 Windows 事件追蹤中追蹤事件
本主題僅適用於 Windows Workflow Foundation 4。
這個範例會示範如何在工作流程服務上啟用 Windows Workflow Foundation (WF) 追蹤以及在 Windows 事件追蹤 (ETW) 中發出追蹤事件。為了將工作流程追蹤記錄發出到 ETW,此範例會使用 ETW 追蹤參與者 (EtwTrackingParticipant)。
範例中的工作流程會接收要求、將對等的輸入資料指派給輸入變數,並將對等項目傳回用戶端。當輸入資料為 0 時,將會發生除以零的例外狀況而無法處理,所以導致工作流程中止。當啟用追蹤時,錯誤追蹤記錄會發出到 ETW,有助於之後的疑難排解。ETW 追蹤參與者會設定追蹤設定檔來訂閱追蹤記錄。追蹤設定檔會定義於 Web.config 檔案中,並當做組態參數提供給 ETW 追蹤參與者。ETW 追蹤參與者會在工作流程服務的 Web.config 檔案中設定,而且會當做服務行為套用到此服務。在這個範例中,您會使用事件檢視器檢視事件記錄檔中的追蹤事件。
工作流程追蹤詳細資料
Windows Workflow Foundation 會提供追蹤基礎結構,以追蹤工作流程執行個體的執行。追蹤執行階段會建立工作流程執行個體,以發出與工作流程開發週期相關的事件、來自工作流程活動的事件和自訂事件。下表詳細說明追蹤基礎結構的主要元件。
元件 | 說明 |
---|---|
追蹤執行階段 |
提供基礎結構以發出追蹤記錄。 |
追蹤參與者 |
存取追蹤記錄。.NET Framework 4 隨附追蹤參與者,可將追蹤記錄當做 Windows 事件追蹤 (ETW) 事件撰寫。 |
追蹤設定檔 |
篩選機制,可讓追蹤參與者訂閱從工作流程執行個體發出之追蹤記錄的子集。 |
下表詳細說明工作流程執行階段發出的追蹤記錄。
追蹤記錄 | 說明 |
---|---|
工作流程執行個體追蹤記錄。 |
描述工作流程執行個體的開發週期。例如,當工作流程開始或完成時,就會發出執行個體記錄。 |
活動狀態追蹤記錄。 |
活動執行詳細資訊。這些記錄會指出工作流程活動的狀態,例如活動排程時間、活動完成時間,或是擲回錯誤的時間。 |
書籤繼續記錄。 |
只要工作流程執行個體中的書籤繼續,就會發出。 |
自訂追蹤記錄。 |
工作流程作者可建立自訂追蹤記錄,並在自訂活動中發出這些記錄。 |
當活動排程另一個活動時,就會發出這個記錄。 |
|
從活動中傳播錯誤時,就會發出這個記錄。 |
|
當另一個活動取消原本的活動時,就會發出這個記錄。 |
追蹤參與者可使用追蹤設定檔訂閱所發出之追蹤記錄的子集。追蹤設定檔包含追蹤查詢,這些查詢允許訂閱特殊追蹤記錄類型。追蹤設定檔可在程式碼或組態中指定。
若要使用這個範例
使用 Visual Studio 2010 開啟 EtwTrackingParticipantSample.sln 方案檔案。
若要建置此方案,請按 F6。
若要執行此方案,請按 F5。
根據預設,此服務會接聽連接埠 53797 (https://localhost:53797/SampleWorkflowService.xamlx)。
使用 Windows 檔案總管開啟 WCF 測試用戶端。
WCF 測試用戶端 (WcfTestClient.exe) 位於 <Visual Studio 2010 安裝資料夾>\Common7\IDE\ 資料夾中。
預設 Visual Studio 2010 安裝資料夾為 C:\Program Files\Microsoft Visual Studio 10.0。
在 WCF 測試用戶端中,選取 [檔案] 功能表上的 [新增服務]。
在輸入方塊中加入端點位址。預設為 https://localhost:53797/SampleWorkflowService.xamlx。
開啟 [事件檢視器] 應用程式。
叫用服務之前,從 [開始] 功能表啟動 [事件檢視器],其方式是選取 [執行],然後輸入 eventvwr.exe。確認事件記錄檔正在接聽從工作流程服務發出的追蹤事件。
在 [事件檢視器] 的樹狀檢視中,巡覽至 [事件檢視器]、[應用程式及服務記錄檔] 和 [Microsoft]。以滑鼠右鍵按一下 [Microsoft],並選取 [檢視],然後選取 [顯示分析與偵錯記錄檔] 來啟用分析和偵錯記錄檔。
確認已核取 [顯示分析與偵錯記錄檔] 選項。
在 [事件檢視器] 的樹狀檢視中,巡覽至 [事件檢視器]、[應用程式及服務記錄檔]、[Microsoft]、[Windows]、[應用程式伺服器-應用程式]。以滑鼠右鍵按一下 [分析] 並選取 [啟用記錄],啟用 [分析] 記錄檔。
若要使用 WCF 測試用戶端測試此服務,請按兩下
GetData
。這樣會開啟
GetData
方法。此要求會接受一個參數,並確定值為 0 (預設值)。按一下 [叫用]。
請查看工作流程所發出的事件。
切換回 [事件檢視器],並巡覽至 [事件檢視器]、[應用程式及服務記錄檔]、[Microsoft]、[Windows]、[應用程式伺服器-應用程式]。以滑鼠右鍵按一下 [分析],並選取 [重新整理]。
工作流程事件會顯示在事件檢視器中。請注意,將會顯示工作流程執行事件,而且其中一個是未處理的例外狀況且對應到工作流程中的錯誤。此外,也會從工作流程活動發出警告事件,指出活動正在擲回錯誤。
使用 0 以外的輸入資料重複步驟 9 和 10,如此一來就不會擲回任何錯誤。
追蹤設定檔可讓您訂閱執行階段在工作流程執行個體狀態變更時,所發出的事件。根據您的監控需求,您可以建立初略的設定檔,使其訂閱工作流程上的一組小型高階狀態變更。在另一方面,您也可以建立非常精確的設定檔,它的輸出非常豐富,足以讓您在日後重新建構執行。此範例示範使用 HealthMonitoring Tracking Profile
從工作流程執行階段發出的事件,它會發出一組小型事件。發出其他工作流程追蹤事件的另一個設定檔名為 Troubleshooting Tracking Profile
,它也會在 Web.config 中提供。當安裝 .NET Framework 4 時,Machine.config 檔案中會設定有空白名稱的預設設定檔。當沒有設定檔名稱或者指定了空的設定檔名稱時,這個設定檔會由 ETW 追蹤行為組態所使用。
狀況監控追蹤設定檔會發出工作流程執行個體記錄及活動錯誤傳播記錄。這個設定檔的建立方式,是將下列追蹤設定檔加入至 Web.config 組態檔。
<<tracking>
<profiles>
<trackingProfile name="HealthMonitoring Tracking Profile">
<workflow activityDefinitionId="*">
<workflowInstanceQueries>
<workflowInstanceQuery>
<states>
<state name="Started"/>
<state name="Completed"/>
<state name="Aborted"/>
<state name="UnhandledException"/>
</states>
</workflowInstanceQuery>
</workflowInstanceQueries>
<faultPropagationQueries>
<faultPropagationQuery faultSourceActivityName ="*" faultHandlerActivityName="*"/>
</faultPropagationQueries>
</workflow>
</trackingProfile>
</profiles>
</tracking>
您可以將 EtwTrackingParticipant
組態變更為以下內容來變更此設定檔。
<behaviors>
<serviceBehaviors>
<behavior>
<etwTracking profileName="HealthMonitoring Tracking Profile"/>
</behavior>
</serviceBehaviors>
</behaviors>
若要清除 (選擇性)
開啟 [事件檢視器]。
巡覽至 [事件檢視器]、[應用程式及服務記錄檔]、[Microsoft]、[Windows]、[應用程式伺服器-應用程式]。以滑鼠右鍵按一下 [分析],並選取 [停用記錄]。
巡覽至 [事件檢視器]、[應用程式及服務記錄檔]、[Microsoft]、[Windows]、[應用程式伺服器-應用程式]。以滑鼠右鍵按一下 [分析],並選取 [清除記錄]。
選擇 [清除] 選項可清除事件。
已知問題
注意: |
---|
在 [事件檢視器] 中有一個可能無法為 ETW 事件解碼的已知問題。您可能會看到類似下面的錯誤訊息。 找不到來自來源 Microsoft-Windows-應用程式伺服器-應用程式之事件識別碼 <id> 的描述。本機電腦可能並未安裝引發此事件的元件,或安裝已損毀。您可以在本機電腦上安裝或修復該元件。 如果您遇到這個錯誤,請按一下執行窗格中的 [重新整理]。現在,此事件應該就會正確解碼。 |
注意: |
---|
這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄,然後再繼續。
<InstallDrive>:\WF_WCF_Samples
如果此目錄不存在,請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文),以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。
<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\EtwTracking
|