在包含相互连接的服务的分布式系统中,必须确定服务之间的因果关系。 了解作为请求流的一部分的各种组件对于支持关键方案(如运行状况监视、疑难解答和根本原因分析)非常重要。 为了在各种服务之间启用跟踪相关性,我们通过以下功能在 .NET Framework 4 中添加了相关支持:
-
分析跟踪:高性能、 低详细级别跟踪功能使用 Windows 事件跟踪 (ETW)。
-
WCF/WF 服务的端到端活动模型:此功能支持通过生成的跟踪相关性xref:System.ServiceModel和xref:System.Workflow.ComponentModel命名空间。
-
WF 的 ETW 跟踪:此功能使用由 WF 服务生成的跟踪记录提供可见性工作流的当前状态和进度。
可使用跟踪或跟踪记录中记录的错误来查找代码缺陷或格式不正确的消息。 可使用事件的邮件头中的“相关性”节点的 ActivityId 属性来确定出错的活动。 若要启用消息流跟踪的活动 ID,请参阅配置消息流跟踪。 本主题演示如何在入门教程中创建的项目中启用消息流跟踪。
在入门教程中启用消息流跟踪
-
通过单击打开事件查看器启动,运行,并输入
eventvwr.exe。 -
如果尚未启用分析跟踪,展开应用程序和服务日志, Microsoft, Windows,应用程序服务器-应用程序. 选择视图,显示分析和调试日志。 右键单击Analytic ,然后选择启用日志。 将事件查看器保持打开状态,以便查看跟踪。
-
打开示例中创建入门教程Visual Studio 2012 中。 请注意,您必须运行 Visual Studio 2012 以管理员身份,以便可以创建服务。 如果您有安装 WCF 示例,可以打开Getting Started,其中包含本教程中创建的已完成的项目。
-
右键单击服务项目,然后选择添加,新项。 选择应用程序配置文件然后单击确定。
-
将下面的代码添加到上一步中创建的 App.Config 文件。
<system.serviceModel> <diagnostics> <endToEndTracing propagateActivity="true" messageFlowTracing="true"/> </diagnostics> </system.serviceModel> -
通过按 Ctrl+F5 来执行该服务器应用程序而不进行调试。 通过右键单击执行客户端项目客户端项目并选择调试,启动新实例。
-
若要跟踪从客户端到服务器的事件,请将以下内容添加到“客户端”项目中的应用程序配置文件。
<diagnostics> <endToEndTracing propagateActivity="true" messageFlowTracing="true"/> </diagnostics> -
在客户端的 Program.cs 中,添加以下 Using 语句。
using System.Diagnostics; -
在客户端项目的 program.cs 文件中的 Main 方法中,将跟踪 GUID 设置为在事件日志中传播。
Guid guid = Guid.NewGuid(); Trace.CorrelationManager.ActivityId = guid; -
刷新并检查分析日志。 查找事件 ID 为 220 的事件。 选择事件,然后单击详细信息在预览窗格中的选项卡。 此事件将包含调用活动的相关 ID。
<Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />NOTE ActivityID 中具有相同 GUID 的所有事件都与一个请求相关。 这可用于关联从特定客户端到特定服务的消息。 如果客户端调用另一个服务,则 ActivityID 可标识相同的客户端。
-
在某些情况下,ActivityID 可从原始 GUID 变为新 ActivityID。 在此情况下,会发出一个传输事件。 此事件 ID 为 499,并且此事件的标头中将包含以下数据。
<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event"> <System> <Provider Name="Microsoft-Windows-Application Server-Applications" Guid="{c651f5f6-1c0d-492e-8ae1-b4efd7c9d503}" /> <EventID>499</EventID> ... <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" RelatedActivityID="{85FC0930-9C49-42DA-804B-A7368104BD1B}" /> ... </System> </Event>NOTE 此传输事件记录了活动 ActivityID 从指定为 ActivityID 的 GUID 到指定为 RelatedActivityID 的 GUID 的更改。 在发出此传输事件后,所有事件都将包含指定为 ActivityID 的新 GUID。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
