大网数据广告活动
.NET 与 C# 开发

ETW 跟踪

· 52CE 我爱测

本示例演示如何通过使用 Windows 事件跟踪 (ETW) 和本示例提供的 ETWTraceListener 来实现端对端 (E2E) 跟踪。 该示例基于Getting Started并包括 ETW 跟踪。

本示例演示如何通过使用 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。

此外可以查看循环跟踪示例执行循环日志记录的替代侦听器的详细信息。

设置、生成和运行示例

  1. 确保您已执行了的 Windows Communication Foundation 示例的一次性安装过程。

  2. 若要生成解决方案,请按照中的说明生成 Windows Communication Foundation 示例。

    NOTE 若要使用 RegisterProvider.bat、SetupETW.bat 和 CleanupETW.bat 命令,必须在本地管理员帐户下运行。 如果使用的是 Windows Vista 或更高版本,则还必须用提升的特权运行命令提示。 为此,请右键单击命令提示符图标,然后单击以管理员身份运行。

  3. 运行示例之前,在客户端和服务器上运行 RegisterProvider.bat。 这会设置生成的 ETWTracingSampleLog.etl 文件以生成可由服务跟踪查看器读取的跟踪。 此文件可以在 C:\logs 文件夹中找到。 如果此文件夹不存在,则必须创建此文件夹;否则将不会生成跟踪。 然后,在客户端和服务器计算机上运行 SetupETW.bat 以开始 ETW 跟踪会话。 SetupETW.bat 文件可以在 CS\Client 文件夹下找到。

  4. 若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。

  5. 示例完成后,运行 CleanupETW.bat 以完成 ETWTracingSampleLog.etl 文件的创建。

  6. 在服务跟踪查看器中打开 ETWTracingSampleLog.etl 文件。 系统会提示您将二进制格式的文件另存为 .svclog 文件。

  7. 从服务跟踪查看器中打开新创建的 .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,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。