Woody：开源Java应用性能诊断分析工具

核心价值

Woody是一款专注于Java应用性能问题诊断的工具，旨在帮助开发者

目前发布第一版，后续会不断丰富功能，不断完善，欢迎感兴趣同行使用，提建议，bug，issue和pr。

后续将持续扩展支持更多中间件

单横杠-表示命令操作，双横杠--表示参数，后续要接参数值

用于指定需要分析的业务入口资源，可同时选择多种中间件的多个入口。

参数	说明
-ls	列举当前应用的所有业务入口资源
-lt	列举当前应用支持的业务资源类型
-s	选择业务入口资源
-us	移除已选中的业务入口资源
-lst	列举已选择的业务入口资源类型列表（未选择时为空）
-lss	列举已选择的业务入口资源
--type	指定中间件类型（支持上述5种类型）
--order	指定中间件业务入口的资源编号（多编号用英文逗号分隔）不指定时表示选择该类型的所有入口资源

用于指定需要采集的性能事件类型，对应async-profiler的4种火焰图类型。

参数	说明
-l	列举当前应用支持的事件类型（注：部分应用可能不支持alloc，取决于JDK版本和操作系统）
-s	选择要采集的事件类型
--cpu	CPU事件，参数为采样间隔（ms）
--alloc	内存分配事件，参数为采样阈值（kb）
--wall	耗时事件，参数为采样间隔（ms）
--lock	锁竞争事件，参数为采样间隔（ms）
-c	清除已选中的事件类型

支持同时选择多个事件类型，将生成对应类型的火焰图

用于控制async-profiler的启动、停止和状态查询。

参数	说明
start	启动性能分析（启动后需在30秒内触发已选择的业务入口请求，否则启动失败）
stop	结束性能分析
status	查询当前性能分析状态（未运行/已运行时长）
--duration	设置分析持续时间（秒），时间到后自动结束（非必须，可通过stop命令提前结束）
--file	指定分析结束后生成的火焰图文件名（默认生成在工具运行目录，多事件时会自动添加类型前缀）（未指定时，采样结果将被缓存，供ts命令使用）

用于检索性能分析样本，支持通过traceId定位特定请求，或查看资源消耗TopN的请求。

参数	说明
-l	列出采样样本（需配合--id或--top参数）
-f	生成火焰图（需配合--id或--top参数）
-c	清除缓存的前次分析样本数据
--file	指定生成的火焰图文件名（配合-f参数使用）
--event	指定分析事件类型（当pe命令选择多个事件时必须指定，单个事件时可省略）
--id	指定traceId（业务请求唯一标识），检索对应请求的样本
--top	指定数量N，检索资源消耗最多的前N个请求ID （将显示样本数量、起止时间等信息）

traceId默认生成规则：1~Long.MAX_VALUE间的随机数

可通过修改ParametricIdGenerator实现自定义traceId生成逻辑（从业务上下文/参数/入口对象提取），下个版本可通过命令及表达式从业务请求生成

本地编译: clone工程，执行 mvn clean package -DskipTests ，boot模块生成的jar包就是工具包，直接运行即可

调试: 待分析应用添加远程debug参数和端口 -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -Xdebug ，woody工程直接远程关联debug即可

火焰图的具体查看方法请参考相关文档或通过AI工具学习。