本示例演示如何通过使用 Windows 事件跟踪 (ETW) 和本示例提供的 ETWTraceListener 来实现端对端 (E2E) 跟踪。 该示例基于Getting Started并包括 ETW 跟踪。
Note: 本主题的最后介绍了此示例的设置过程和生成说明。
此示例假定你熟悉跟踪和消息日志记录。
xref:System.Diagnostics 跟踪模型中的每个跟踪源都可以具有多个跟踪侦听器,这些侦听器确定跟踪数据的位置和方式。 侦听器的类型定义记录跟踪数据的格式。 下面的代码示例演示如何向配置中添加侦听器。
<system.diagnostics>
<sources>
<source name="System.ServiceModel"
switchValue="Verbose,ActivityTracing"
propagateActivity="true">
<listeners>
<add type=
"System.Diagnostics.DefaultTraceListener"
name="Default">
<filter type="" />
</add>
<add name="ETW">
<filter type="" />
</add>
</listeners>
</source>
</sources>
<sharedListeners>
<add type=
"Microsoft.ServiceModel.Samples.EtwTraceListener, ETWTraceListener"
name="ETW" traceOutputOptions="Timestamp">
<filter type="" />
</add>
</sharedListeners>
</system.diagnostics>
在使用此侦听器之前,必须启动 ETW 跟踪会话。 可以通过使用 Logman.exe 或 Tracelog.exe 来启动此会话。 本示例随附一个 SetupETW.bat 文件,您可以和 CleanupETW.bat 文件一起使用此文件来设置 ETW 跟踪会话,以便关闭会话并完成日志文件。
Note: 本主题的最后介绍了此示例的设置过程和生成说明。 有关这些工具的详细信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=56580
使用 ETWTraceListener 时,将在二进制 .etl 文件中记录跟踪。 在打开 ServiceModel 跟踪的情况下,所有生成的跟踪都显示在同一个文件中。 使用Service Trace Viewer Tool (SvcTraceViewer.exe)用于查看.etl 和.svclog 日志文件。 该查看器可创建系统的端对端视图,可以从消息源到消息目标和使用点来跟踪消息。
ETW 跟踪侦听器支持循环记录。 若要启用此功能,请转到启动,运行并键入cmd以启动命令控制台。 在下面的命令中,用日志文件的名称替换 <logfilename> 参数。
logman create trace Wcf -o <logfilename> -p "{411a0819-c24b-428c-83e2-26b41091702e}" -f bincirc -max 1000
-f 和 -max 开关是可选的。 它们分别指定二进制循环格式和 1000 MB 的最大日志大小。 -p 开关用于指定跟踪提供程序。 在我们的示例中,"{411a0819-c24b-428c-83e2-26b41091702e}" 是“XML ETW 示例提供程序”的 GUID。
若要启动会话,请键入以下命令。
Logman start Wcf
在完成日志记录后,可以用下面的命令停止会话。
Logman stop Wcf
此过程会生成与所选的工具可以处理的二进制循环日志包括Service Trace Viewer Tool (SvcTraceViewer.exe)或 Tracerpt。
此外可以查看循环跟踪示例执行循环日志记录的替代侦听器的详细信息。
设置、生成和运行示例
-
若要生成解决方案,请按照中的说明生成 Windows Communication Foundation 示例。
NOTE 若要使用 RegisterProvider.bat、SetupETW.bat 和 CleanupETW.bat 命令,必须在本地管理员帐户下运行。 如果使用的是 Windows Vista 或更高版本,则还必须用提升的特权运行命令提示。 为此,请右键单击命令提示符图标,然后单击以管理员身份运行。
-
运行示例之前,在客户端和服务器上运行 RegisterProvider.bat。 这会设置生成的 ETWTracingSampleLog.etl 文件以生成可由服务跟踪查看器读取的跟踪。 此文件可以在 C:\logs 文件夹中找到。 如果此文件夹不存在,则必须创建此文件夹;否则将不会生成跟踪。 然后,在客户端和服务器计算机上运行 SetupETW.bat 以开始 ETW 跟踪会话。 SetupETW.bat 文件可以在 CS\Client 文件夹下找到。
-
若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。
-
示例完成后,运行 CleanupETW.bat 以完成 ETWTracingSampleLog.etl 文件的创建。
-
在服务跟踪查看器中打开 ETWTracingSampleLog.etl 文件。 系统会提示您将二进制格式的文件另存为 .svclog 文件。
-
从服务跟踪查看器中打开新创建的 .svclog 文件以查看 ETW 和 ServiceModel 跟踪。
Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:
<InstallDrive>:\WF_WCF_Samples如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:
<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\AnalyticTrace
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
