`async-profiler` 快速入门指南

1. 项目目录结构及介绍

async-profiler 的源码仓库通常包含以下目录：

• src：源代码存放处，包括C++代码和相关的头文件。
• scripts：脚本文件，用于辅助编译、安装和使用async-profiler。
• examples：包含示例配置文件和用法说明。
• doc：文档，可能包括README或其他形式的文档资料。
• build：构建过程产生的中间文件和最终的库文件。

核心组件

• libasyncProfiler.so：这是一个动态链接库，是async-profiler的主要实现，提供了CPU和内存采样的功能。

2. 项目的启动文件介绍

async-profiler 主要通过命令行接口操作，其核心命令有以下几个：

• start：启动性能采样。
• stop：停止正在运行的采样。
• status：查看当前状态，是否在采样。
• profiler.sh：主入口脚本，通常用于连接到Java进程并执行上述命令。

示例启动方式

# 下载并解压缩async-profiler
wget https://github.com/jvm-profiling-tools/async-profiler/releases/download/v1.8.1/async-profiler-1.8.1-linux-x64.tar.gz
tar xvf async-profiler-1.8.1-linux-x64.tar.gz

# 获取Java进程ID
export PID=$(jps | grep YourJavaProcessName | awk '{print $1}')

# 启动CPU采样，每1ms采样一次
./async-profiler/start.sh -d $PID -i 1000

3. 项目的配置文件介绍

async-profiler 通常不需要复杂的配置文件，但可以通过命令行选项来定制采样行为。这些选项可以分为几类：

• 采样频率 (-i): 例如 -i 1000000，表示每1,000,000纳秒（即1毫秒）采样一次。
• 事件类型 (-e): 默认是CPU使用率，也可以设置为内存分配(alloc)等其他事件。
• 过滤规则 (-f/-l/-k/-p): 用于包含或排除特定的方法、类或线程。
• 输出控制 (-o/-F/-T): 控制输出格式（如火焰图、文本、JFR）和文件名。
• 采样持续时间 (-d): 设定采样持续的时间，以秒为单位。

示例配置命令行

# 持续5秒采样，只关注名为'com.example.MyClass'的方法
./async-profiler/start.sh -d 5 -e cpu -f 'com.example.MyClass.*'

请注意，虽然async-profiler本身没有固定的配置文件，但它可以根据需要与其他配置管理工具结合使用，通过命令行参数传递定制的配置信息。

---

以上是async-profiler的基本介绍和使用方法，详细用法和更多选项可以查阅项目文档或官方GitHub页面。