ETWAnalyzer使用指南

ETWAnalyzer使用指南

ETWAnalyzer Command line tool to analyze one/many ETW file/s with simple queries for common issues. 项目地址: https://gitcode.com/gh_mirrors/et/ETWAnalyzer

项目介绍

ETWAnalyzer 是一个命令行工具，专为分析一个或多个事件跟踪（ETW）文件而设计。该工具由Siemens Healthineers开发并维护，旨在从Windows系统的大型ETL文件中提取关键性能数据，并将其压缩成便于分析的json7z文件。通过利用Windows内置的事件追踪技术，ETWAnalyzer允许开发者和系统分析师快速识别性能瓶颈和回归问题，无需将整个GB级别的ETL文件导入如Windows Performance Analyzer(WPA)这样的慢速分析工具。

它支持快速查询，适用于性能趋势测试场景，特别是当面对大量ETL文件时，它的效率远超其他公开可用的工具。ETWAnalyzer遵循MIT开源协议，并详细列出了所依赖的开源及第三方软件。

项目快速启动

要开始使用ETWAnalyzer，首先确保你的环境已安装了Git和.NET环境。然后，克隆该项目到本地：

git clone https://github.com/Siemens-Healthineers/ETWAnalyzer.git

构建并运行工具，你可以通过以下步骤进行简单的性能问题排查：

1. 下载示例测试数据：

curl https://raw.githubusercontent.com/Siemens-Healthineers/ETWAnalyzer/main/ETWAnalyzer_uTest/TestData/CallupAdhocWarmReadingCT_3117msFO9DE01T0162PC_20200717-124447.json -o c:\Temp\ETWAnalyzerTest.json

2. 运行ETWAnalyzer进行分析：

ETWAnalyzer -console load c:\Temp\ETWAnalyzerTest.json dump CPU -topN 1 -methods * -sortby stackdepth -MinMaxCPUMs 1000

这将会展示CPU使用率最高的方法及其调用栈，帮助迅速定位性能热点。

应用案例和最佳实践

性能瓶颈检测

在处理长时间运行的应用或服务时，ETWAnalyzer可以用来定期采集性能数据。例如，在部署新版本前后的性能对比，可通过以下步骤进行：

1. 使用wpr工具捕获ETL文件。
2. 将捕获的数据转换给ETWAnalyzer分析：

   ETWAnalyzer -load path_to_your.etl -dump CPU -pn YourAppNamespace -MinMaxCPUMs 50s-60s -id
   

   此命令将分析指定的时间段内特定命名空间的方法CPU使用情况。

监控持续集成环境

集成ETWAnalyzer到CI/CD流程，可自动化性能监控，确保每次代码变更不会引入重大性能下降。

典型生态项目

虽然ETWAnalyzer本身是独立的，但它与Windows性能分析生态紧密相连。例如，配合使用Windows的性能记录工具(wpr/wpa)收集数据，以及在DevOps流程中结合Azure Pipelines或Jenkins，用于自动化性能测试报告生成，可增强软件质量保证的链条。此外，对于那些寻求进一步ETL数据分析自定义能力的开发者，了解PerfView等其他ETW分析工具也是有益的，尽管它们的功能更为复杂，但可以作为ETWAnalyzer的补充。

---

以上简要介绍了ETWAnalyzer的基本用法和应用场景。通过实际操作和实践这些步骤，开发者将能更有效地诊断和解决应用程序中的性能问题。

ETWAnalyzer Command line tool to analyze one/many ETW file/s with simple queries for common issues. 项目地址: https://gitcode.com/gh_mirrors/et/ETWAnalyzer