Arthas profiler（使用async-profiler对应用采样，生成火焰图）

@[toc]

二、命令列表

2.4 profiler（使用async-profiler对应用采样，生成火焰图）

使用场景：

profiler 命令支持生成应用热点的火焰图。本质上是通过不断的采样，然后把收集到的采样结果生成火焰图。
提示

使用async-profiler在新窗口打开生成火焰图

火焰图的含义：

火焰图是基于 perf 结果产生的SVG 图片，用来展示 CPU 的调用栈。

y 轴表示调用栈，每一层都是一个函数。调用栈越深，火焰就越高，顶部就是正在执行的函数，下方都是它的父函数。

x 轴表示抽样数，如果一个函数在 x 轴占据的宽度越宽，就表示它被抽到的次数多，即执行的时间长。注意，x 轴不代表时间，而是所有的调用栈合并后，按字母顺序排列的。

火焰图就是看顶层的哪个函数占据的宽度最大。只要有"平顶"（plateaus），就表示该函数可能存在性能问题。

颜色没有特殊含义，因为火焰图表示的是 CPU 的繁忙程度，所以一般选择暖色调。

注意：生成的火焰图要从linux服务器下载到本地然后才能打开，而不是浏览器直接输入IP:端口去打开，那样无效。

profiler 命令支持生成应用热点的火焰图。本质上是通过不断的采样，然后把收集到的采样结果生成火焰图。

css 复制代码

profiler 命令基本运行结构是： 
profiler action [actionArg]

profiler 命令的格式基本与上游项目 async-profiler在新窗口打开保持一致，详细的使用方式可参考上游项目的 README、Github Disscussions 以及其他文档资料。

参数说明：

参数名称	参数说明
action	要执行的操作
actionArg	属性名模式
[i:]	采样间隔（单位：ns）（默认值：10'000'000，即 10 ms）
[f:]	将输出转储到指定路径
[d:]	运行评测指定秒
[e:]	要跟踪哪个事件（cpu, alloc, lock, cache-misses 等），默认是 cpu

常用命令：

profiler	命令作用
profiler start	启动profiler，默认情况下，生成cpu的火焰图
profiler list	显示所有支持的事件
profiler getSamples	获取已采集的sample的数量
profiler status	查看profiler的状态，运行的时间
profiler stop	停止profiler，生成火焰图的结果，指定输出目录和输出格式：svg或html

启动profiler ，默认情况下，生成的是 cpu 的火焰图，即 event 为cpu。可以用--event参数指定其他性能分析模式，见下文。
css 复制代码
```
$ profiler start
Started [cpu] profiling
```
显示支持的事件
复制代码
```
profiler list
```
获取已采集的sample的数量
ruby 复制代码
```
$ profiler getSamples
23
```
查看profiler状态 (可以查看当前profiler在采样哪种event和采样时间。)
csharp 复制代码
```
$ profiler status
[cpu] profiling is running for 4 seconds
```
停止profiler，并同步生成文件 （默认在工作目录下的arthas-output目录。）
javascript 复制代码
```
$ profiler stop
profiler output file: /tmp/demo/arthas-output/20240919-155147.svg
```
通过 --file参数来指定输出结果路径 ，在--file参数指定的文件名后缀为 html 或 jfr 时，文件格式可以被推断出来。比如--file /tmp/result.html 将自动生成火焰图。
bash 复制代码
```
# 指定生成的文件名以及路径
profiler stop --file /tmp/result.svg
```
可以用--format指定生成格式 ，默认情况下，结果是 Flame Graph格式的 html 文件，也可以用 -o 或 --format 参数指定其他内容格式，包括 flat、traces、collapsed、flamegraph、tree、jfr。
css 复制代码
```
profiler stop --format html
```
生成的图

profiler 支持的 events

在不同的平台，不同的 OS 下面，支持的 events 各有不同。比如在 macos 下面：

csharp 复制代码

$ profiler list
Basic events:
  cpu
  alloc
  lock
  wall
  itimer

在 linux 下面

lua 复制代码

$ profiler list
Basic events:
  cpu
  alloc
  lock
  wall
  itimer
Java method calls:
  ClassName.methodName
Perf events:
  page-faults
  context-switches
  cycles
  instructions
  cache-references
  cache-misses
  branch-instructions
  branch-misses
  bus-cycles
  L1-dcache-load-misses
  LLC-load-misses
  dTLB-load-misses
  rNNN
  pmu/event-descriptor/
  mem:breakpoint
  trace:tracepoint
  kprobe:func
  uprobe:path

如果遇到 OS 本身的权限/配置问题，然后缺少部分 event，可以参考 async-profiler 的文档在新窗口打开。

可以使用 check action 测试某个 event 是否可用，此 action 的参数格式与 start 一致。

可以用--event参数指定要采样的事件，比如 alloc 表示分析内存分配情况：

sql 复制代码

$ profiler start --event alloc

重要信息

官网：ais.cn/u/vEbMBz

Arthas profiler（使用async-profiler对应用采样，生成火焰图）

二、命令列表

2.4 profiler（使用async-profiler对应用采样，生成火焰图）

profiler 支持的 events

本人其他相关文章链接