本主题介绍 Windows Communication Foundation (WCF) 跟踪模型中的活动跟踪。 活动是帮助用户缩小故障范围的处理单位。 在同一活动中发生的错误直接相关。 例如,消息解密失败可导致操作失败。 操作失败和消息解密失败的跟踪出现在同一活动中,表明解密错误和请求错误之间直接相关。
配置活动跟踪
WCF 提供了用于处理应用程序的预定义的活动 (请参阅活动列表)。 您还可以用编程方式定义活动,以便对用户跟踪进行分组。 有关详细信息,请参阅发出用户代码跟踪。
若要在运行时发出活动跟踪,请使用ActivityTracing设置为System.ServiceModel跟踪源,或者其他 WCF 或自定义跟踪源,如以下配置代码所示。
<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing">
若要了解有关的配置元素和属性所使用的详细信息,请参阅配置跟踪主题。
查看活动
您可以查看的活动,并且在其实用性Service Trace Viewer Tool (SvcTraceViewer.exe)。 启用 ActivityTracing 后,此工具将获得跟踪并基于活动对它们进行分类。 您还可以查看跟踪传输。 跟踪传输指示不同的活动如何互相关联。 您可以看到某个特定活动导致另外一个活动启动。 例如,消息请求可启动安全握手以获取安全对话令牌。
在服务跟踪查看器中关联活动
服务跟踪查看器工具提供了两个活动视图:
-
列表视图,其中的活动 ID 用于跨进程直接关联跟踪。 来自不同进程(例如客户端和服务)但具有相同活动 ID 的跟踪被分组到同一活动中。 因此,如果在服务上发生一个错误,然后该错误又导致客户端上发生错误,那么这两个错误都将出现在该工具的同一活动视图中。
-
图形视图中,活动按进程分组。 在此视图中,具有相同活动 ID 的客户端和服务的跟踪位于不同的活动中。 为了将位于不同进程但具有相同活动 ID 的活动相互关联,该工具显示了跨越相关活动的消息流。
有关详细信息,以及若要查看服务跟踪查看器工具的图形视图,请参阅Service Trace Viewer Tool (SvcTraceViewer.exe)和使用服务跟踪查看器查看相关跟踪和故障排除。
定义活动范围
活动是在设计时定义的,并且表示一个逻辑工作单元。 所发出的具有相同活动标识符的跟踪直接相关,它们都属于同一个活动。 因为一个活动可能跨越终结点边界(请求),所以为活动定义两个范围。
-
Global范围,限于每个应用程序。 在此范围中,活动由其 128 位全局唯一活动标识符 gAId 进行标识。 gAid 是跨越终结点传播的内容。 -
以终结点为边界的
Local范围。 在此范围中,活动由它的 gAId 以及发出活动跟踪的跟踪源名称和进程 ID 标识。这三部分内容构成了本地活动 ID,即 lAId。 lAId 用于定义活动的(本地)边界。
跟踪架构
可以使用任何架构以及跨 Microsoft 平台发出跟踪。 "e2e"(表示"端到端") 是常用的架构。 此架构包含一个 128 位标识符 (gAId)、跟踪源名称和进程 ID。 在托管代码中,xref:System.Diagnostics.XmlWriterTraceListener 可在 E2E 架构中发出跟踪。
开发人员可以通过使用线程本地存储 (TLS) 上的 Guid 设置 xref:System.Diagnostics.CorrelationManager.ActivityId* 属性来设置随跟踪发出的 AID。 下面的示例演示这一操作。
// set the current Activity ID to a new GUID.
CorrelationManager.ActivityId = Guid.NewGuid();
使用跟踪源发出跟踪时,设置 TLS 中的 gAId 非常简单,如下面的示例所示。
TraceSource traceSource = new TraceSource("myTraceSource");
traceSource.TraceEvent(TraceEventType.Warning, eventId, "Information");
发出的跟踪将包含当前 TLS 中的 gAId、作为参数传递给跟踪源构造函数的跟踪源名称和当前进程的 ID。
活动生存期
用最严格的术语表述,活动的证据从第一次在发出的跟踪中使用活动 ID 时开始,到最后一次在发出的跟踪中使用活动 ID 时结束。 xref:System.Diagnostics 提供了一组预定义的跟踪类型(包括“开始”和“停止”),以便显式标记活动生存期边界。
-
启动:指示活动开始。 "开始"跟踪提供开始新的处理里程碑的记录。 它包含给定进程中给定跟踪源的新活动 ID,但是,当活动 ID 跨越终结点传播时除外 — 在这种情况下,我们会在每个终结点中看到一个“开始”跟踪。 开始新活动的示例包括创建新的处理线程或进入新的公共方法。
-
停止:指示活动结束。 "停止"跟踪提供结束现有处理里程碑的记录。 它包含给定进程中给定跟踪源的现有活动 ID,但在终结点之间传播活动 ID 时除外。在这种情况下,我们会在每个终结点中看到一个“停止”跟踪。 停止活动的示例包括终止处理线程或退出的方法开始时表示为"开始"跟踪。
-
挂起:指示活动的处理已挂起。 "挂起"跟踪包含其处理预期在以后恢复一个现有活动 ID。 在“挂起”和“恢复”事件之间,不会从当前跟踪源发出具有此 ID 的跟踪。 示例包括调用外部库函数或等待资源(如 I/O 完成端口)时暂停一个活动。
-
恢复:指示继续处理活动。 "恢复"跟踪包含从当前跟踪源发出的最后一个跟踪是"挂起"跟踪一个现有活动 id。 示例包括从对外部库函数的调用返回或发出让资源(如 I/O 完成端口)恢复处理的信号。
-
传输:因为一些活动由其他人,或与其他人,可以通过"转换"跟踪的其他活动与相关活动。 转换跟踪记录了活动之间的定向关系。
“开始”和“停止”跟踪并不是关联所必需的。 然而,它们可以帮助提高性能、分析和验证活动范围。
使用这些类型时,工具可以优化跟踪日志的导航以查找同一活动的直接相关事件,或者如果工具追踪传输跟踪,可查找相关活动中的事件。 例如,当工具遇到开始/停止跟踪时,将停止分析给定活动的日志。
这些跟踪类型也可以用于分析。 在开始和停止标记之间消耗的资源表示活动的全部时间,包括所包含的逻辑活动时间。 减去“挂起”和“恢复”跟踪之间的时间间隔就得到实际活动时间。
“停止”跟踪还对验证已实现活动的范围特别有用。 如果某些处理跟踪出现在停止跟踪之后,而不是出现在给定活动之内,这可能暗示代码有缺陷。
活动跟踪使用指南
以下是使用 ActivityTracing 跟踪(开始、停止、挂起、恢复和转换)的指南。
-
跟踪是一个定向循环图,而不是树。 可以将控制返回到生成活动的活动。
-
活动表示一个处理边界,该边界对于系统管理员可能很有意义,或者可以用来实现可支持性。
-
每个 WCF 方法,同时在客户端和服务器受限于由开始一个新的活动,然后 (在工作完成) 之后结束该新活动并将返回到环境活动。
-
长时间运行(正在运行)的活动(例如,侦听连接或等待消息)由相应的开始/停止标记表示。
-
由接收或处理消息触发的活动由跟踪边界来表示。
-
活动表示的是活动本身,而未必是对象。 活动应解释为"这发生的情况时。 . . (发出有意义的跟踪)时发生的”。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
