# 自定义 profiler 配置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 配置：  `设置 | 构建、执行、部署 | Java Profiler`

对于 CPU 和分配分析，IntelliJ IDEA 提供与以下分析器的集成：

* Java Flight Recorder – 作为 JDK 的一部分随附的标准分析工具。

* 异步分析器 – 一款非常准确的分析器，也可以收集本机调用和内存分配数据。

默认情况下，IntelliJ IDEA 会并行运行两个分析器，以提供最准确的结果。 虽然可以单独使用受支持的分析器，但开箱即用的组合配置对于大多数场景是更好的选择。 这种方法利用了两种分析器的优势，并且除非有非常具体的要求，否则无需进行任何设置。

Async Profiler   和   Java Flight Recorder   配置让您可以单独运行这些工具并根据具体要求进行微调。 本主题介绍如何设置这些配置和环境。

Procedure: 创建单独的 profiler 配置

1. 前往  `设置 | 构建、执行、部署 | Java Profiler` 。

2. 点击   添加新配置   并选择分析器。

3. 根据需要修改 profiler 选项。

有关选项的意义和目的，请分别参阅 [Async Profiler](#async-options)和 [Java Flight Recorder](#configure-jfr)章节。

## Async Profiler

> **Note:**
> Async profiler 兼容 HotSpot JVM 和 [一些其他 Java 运行时](https://github.com/jvm-profiling-tools/async-profiler/blob/master/README.md#async-profiler)。

在 Windows 和 macOS 上，分析器开箱即用。 如果您使用的是 Linux，在开始 Profiling 之前，您必须调整 kernel 选项。

Procedure: 在 Linux 上调整 kernel 选项

1. 调整  perf_event_paranoid 。 此选项控制非 root 用户对性能事件数据的使用。

将该值设置小于 2 以使性能分析器在无 root 权限的情况下收集性能信息：

```CONSOLE
sudo sh -c 'echo 1 >/proc/sys/kernel/perf_event_paranoid'

```

2. 调整  kptr_restrict 。 此选项设置暴露内核地址的限制。

要正确解析内核符号，请通过将  kptr_restrict  的值设置为 0 来禁用其提供的保护：

```CONSOLE
sudo sh -c 'echo 0 >/proc/sys/kernel/kptr_restrict'

```

默认情况下，这些更改仅影响您当前的操作系统会话。 要在系统重启后保持这些设置，请运行：

```CONSOLE
sudo sh -c 'echo kernel.perf_event_paranoid=1 >> /etc/sysctl.d/99-perf.conf'
sudo sh -c 'echo kernel.kptr_restrict=0 >> /etc/sysctl.d/99-perf.conf'
sudo sh -c 'sysctl --system'

```

### 配置选项

> **Note:**
> 您可以在 [GitHub上的官方文档](https://github.com/jvm-profiling-tools/async-profiler)中找到有关 Async Profiler 配置的详细解释。

|  选项  |  描述  |
| --- | --- |
|  代理选项  |  将传递给代理的选项。 例如，它们可以用于启用壁挂式时钟分析，或调整采样间隔。  |
|  代理  |  将用于分析的代理。  |

## Java Flight Recorder

Java Flight Recorder 可在 Windows、Linux 和 macOS 上使用。  在以下 JDK 版本中，原生支持：

* Oracle JDK 8-10：前提是 `解锁商业功能` VM 选项 [启用](#java-version-jfr)

* Oracle JDK 11 及以上版本

* OpenJDK 11 及更新版本

Procedure: 为 Oracle JDK 8-11 启用 JFR

1. 在主菜单中，前往  `运行 | 编辑配置` ，然后从左侧列表中选择要用 JFR 分析的运行配置。

2. 在   VM 选项   字段中，添加以下行：  `-XX:+UnlockCommercialFeatures` 。

> **Warning:**
> 该标志解锁了 Oracle Java SE Advanced 或 Oracle Java SE Suite 中的商业功能。 在启用它们之前，请仔细阅读 [Oracle Java SE 平台产品二进制代码许可协议](https://www.oracle.com/technetwork/java/javase/terms/products/index.html)。

3. 应用更改并关闭对话框。

![启用 JFR](https://resources.jetbrains.com/help/img/idea/2026.3/unlock-jfr.png)

### JFR 配置

有两个预装的配置：   默认  和   配置文件  。   默认   配置具有低开销（约 1%）。 这就是它适合连续分析的原因。   配置文件   配置有大约 2% 的开销，可用于更详细的应用性能分析。

这些配置涵盖了大多数用例。 您可以在  `设置 | 构建、执行、部署 | Java Profiler | Java Flight Recorder`  中选择最合适的配置。

如果预定义配置无法满足您的需求，您可以通过   Java Mission Control  创建并上传您自己的设置。

Procedure: 创建自定义 JFR 配置（可选）

1. 您能在  `JAVA_HOME/bin/jmc`  中找到 Java Mission Control 或从 [https://jdk.java.net/jmc/](https://jdk.java.net/jmc/) 下载。

2. 从 Java Mission Control 主菜单中选择  `窗口 | Flight Recording Template Manager.`

3. 点击   导入文件   位于右侧面板，并选择  `.jfc`  格式中的一个预安装配置：

* Java 10 及以前版本： `JAVA_HOME/jre/lib/jfr/`

* 对于 Java 11 及更高版本： `JAVA_HOME/Contents/Home/lib/jfr/`

4. 选择  `编辑｜高级` ，更改必要的设置，然后点击   OK  。

5. 在   飞行记录模板管理器  对话框中，点击   导出文件  。

6. 请为新设置文件指定另一个名称，并根据需要更改其位置。 点击   保存  。

有关配置自定义设置的更多信息，请参考 [使用模板控制录制数据](https://docs.oracle.com/cd/E15289_01/JRMCF/config_rec_data.htm)。

> **Tip:**
> 默认情况下，Windows 上的  `JAVA_HOME` 路径是：  `C:\Program Files\Java` ，macOS 上的路径是：  `/Library/Java/JavaVirtualMachines` 。

Procedure: 将自定义配置加载到 IDE（可选）

1. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择  `构建、执行、部署 | Java Profiler` 。

2. 请选择您要加载自定义设置的 Java Flight Recorder 分析配置，或通过点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)创建一个新配置。

3. 在   分析设置  区域，选择   自定义设置文件  选项并点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)。

4. 指定自定义设置文件的路径并点击   打开  。

5. 应用更改并关闭对话框。

