You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
arthas/_sources/profiler.md.txt

173 lines
3.6 KiB
Plaintext

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

profiler
===
> 使用[async-profiler](https://github.com/jvm-profiling-tools/async-profiler)生成火焰图
`profiler` 命令支持生成应用热点的火焰图。本质上是通过不断的采样,然后把收集到的采样结果生成火焰图。
`profiler` 命令基本运行结构是 `profiler action [actionArg]`
### 启动profiler
```
$ profiler start
Started [cpu] profiling
```
> 默认情况下生成的是cpu的火焰图即event为`cpu`。可以用`--event`参数来指定。
### 获取已采集的sample的数量
```
$ profiler getSamples
23
```
### 查看profiler状态
```bash
$ profiler status
[cpu] profiling is running for 4 seconds
```
可以查看当前profiler在采样哪种`event`和采样时间。
### 停止profiler
#### 生成svg格式结果
```
$ profiler stop
profiler output file: /tmp/demo/arthas-output/20191125-135546.svg
OK
```
默认情况下,生成的结果保存到应用的`工作目录`下的`arthas-output`目录。可以通过 `--file`参数来指定输出结果路径。比如:
```bash
$ profiler stop --file /tmp/output.svg
profiler output file: /tmp/output.svg
OK
```
#### 生成html格式结果
默认情况下,结果文件是`svg`格式,如果想生成`html`格式,可以用`--format`参数指定:
```bash
$ profiler stop --format html
profiler output file: /tmp/test/arthas-output/20191125-143329.html
OK
```
或者在`--file`参数里用文件名指名格式。比如`--file /tmp/result.html` 。
### 通过浏览器查看arthas-output下面的profiler结果
默认情况下arthas使用3658端口则可以打开 [http://localhost:3658/arthas-output/](http://localhost:3658/arthas-output/) 查看到`arthas-output`目录下面的profiler结果
![](_static/arthas-output.jpg)
点击可以查看具体的结果:
![](_static/arthas-output-svg.jpg)
> 如果是chrome浏览器可能需要多次刷新。
### profiler支持的events
在不同的平台不同的OS下面支持的events各有不同。比如在macos下面
```bash
$ profiler list
Basic events:
cpu
alloc
lock
wall
itimer
```
在linux下面
```bash
$ profiler list
Basic events:
cpu
alloc
lock
wall
itimer
Perf events:
page-faults
context-switches
cycles
instructions
cache-references
cache-misses
branches
branch-misses
bus-cycles
L1-dcache-load-misses
LLC-load-misses
dTLB-load-misses
mem:breakpoint
trace:tracepoint
```
如果遇到OS本身的权限/配置问题,然后缺少部分event可以参考`async-profiler`本身文档:[async-profiler](https://github.com/jvm-profiling-tools/async-profiler)
可以用`--event`参数指定要采样的事件,比如对`alloc`事件进入采样:
```bash
$ profiler start --event alloc
```
### 恢复采样
```bash
$ profiler resume
Started [cpu] profiling
```
`start`和`resume`的区别是:`start`是新开始采样,`resume`会保留上次`stop`时的数据。
通过执行`profiler getSamples`可以查看samples的数量来验证。
### 使用`execute`来执行复杂的命令
比如开始采样:
```bash
profiler execute 'start'
```
停止采样,并保存到指定文件里:
```bash
profiler execute 'stop,file=/tmp/result.svg'
```
具体的格式参考: [arguments.cpp#L34](https://github.com/jvm-profiling-tools/async-profiler/blob/v1.6/src/arguments.cpp#L34)
### 查看所有支持的action
```bash
$ profiler actions
Supported Actions: [resume, dumpCollapsed, getSamples, start, list, execute, version, stop, load, dumpFlat, actions, dumpTraces, status]
```
### 查看版本
```bash
$ profiler version
Async-profiler 1.6 built on Sep 9 2019
Copyright 2019 Andrei Pangin
```