JProfiler帮助文档

安装 JProfiler

Windows 和 Linux/Unix 提供可执行安装程序,能够引导您逐步完成安装过程。 如果检测到已有的安装,安装流程将会简化。

在 macOS 上,JProfiler 使用 UI 应用程序的标准安装流程:通过双击 DMG 文件在 Finder 中挂载, 然后将 JProfiler 应用程序包拖动到 /Applications 文件夹。该文件夹 在 DMG 中以符号链接的形式可见。

在 Linux/Unix 上,安装程序下载后默认不可执行,因此需要在执行时前置 sh。 如果传递参数 -c,安装程序将以命令行方式安装。 对于 Windows 和 Linux/Unix 的全自动静默安装,可以使用参数 -q。 此时,可以通过附加参数 -dir <directory> 来选择安装目录。

运行安装程序后,会保存一个文件 .install4j/response.varfile,其中包含了所有用户输入。 您可以将该文件用于自动化静默安装,只需在命令行中传递参数 -varfile <path to response.varfile> 即可。

要为静默安装设置授权信息,请传递 -Vjprofiler.licenseKey=<license key> -Vjprofiler.licenseName=<user name>,也可以选择性地 添加 -Vjprofiler.licenseCompany=<company name> 作为命令行参数。 如果您使用的是浮动许可证,请将授权密钥替换为 FLOAT:<server name or IP address>

还提供了 Windows 的 ZIP 文件和 Linux 的 .tar.gz 文件格式归档包。可以使用如下命令解压:

tar xzvf filename.tar.gz

该命令会将 .tar.gz 归档包解压到一个独立的顶级目录下。 启动 JProfiler 时,在解压目录下执行 bin/jprofiler。在 Linux/Unix 下, jprofiler.desktop 文件可用于将 JProfiler 可执行文件集成到您的窗口管理器中。 例如,在 Ubuntu 上,您可以将该 desktop 文件拖动到启动器侧边栏,从而创建一个永久的启动项。

分发 profiling agent 到远程机器

JProfiler 包含两个部分:一方面是桌面 UI 及用于快照操作的命令行工具,另一方面是 profiling agent 及用于控制被分析 JVM 的命令行工具。 您从官网下载安装包或归档包时,二者均包含在内。

但对于远程分析,只需在远程端安装 profiling agent。 您可以直接在远程机器上解压 JProfiler 的归档包,也可以根据实际需求减少所需文件数量,特别是在自动化部署时。 此外,profiling agent 可自由分发,因此可以随应用程序一同发布,或安装到客户机器上以便故障排查。

若需获取仅包含 profiling agent 的最小化包,远程集成向导会显示适用于目标平台的 agent 归档包下载链接,以及所有支持平台的 agent 归档包下载页面。 在 JProfiler GUI 中,依次选择 Session→Integration Wizards→New Server/Remote Integration, 选择 “Remote” 选项,然后进入 Remote installation directory 步骤。

某一特定 JProfiler 版本的 HTML 概览页面的 URL 为:

https://www.ej-technologies.com/jprofiler/agent?version=16.0

单个 agent 归档包的下载链接格式如下:

https://download.ej-technologies.com/jprofiler/jprofiler_agent_<platform>_16_0.<extension>

其中 platform 对应 bin 目录下的 agent 子目录名, extension 在 Windows 上为 zip,macOS 上为 .tgz, Linux/Unix 上为 .tar.gz。对于 Linux,x86 和 x64 合并为同一归档包,因此 Linux x64 的下载链接为:

https://download.ej-technologies.com/jprofiler/jprofiler_agent_linux-x86_16_0.tar.gz

agent 归档包中包含所需的本地 agent 库,以及 jpenable jpdump jpcontroller 可执行文件。归档包中的可执行文件和 profiling agent 仅需 Java 8 及以上版本即可运行。

在远程机器上解压 agent 归档包后,您会看到如下子目录。 这些子目录是完整 JProfiler 安装包在目标平台上的子集。

提取后的顶级目录.install4jbin<platform-64><platform-32>lib代理 JAR 文件和辅助可执行文件64位JVM的本机库32位JVM的本机库附加功能的支持库运行时库用于启动器

支持的平台

由于 JProfiler 利用 JVM(JVMTI)的本地 profiling 接口,其 profiling agent 是一个本地库(library)。

JProfiler 16 支持在以下平台进行分析:

操作系统 架构 支持的 JVM 版本
Windows 11/10
Windows Server 2025/2022/2019/2016
x86
x64/AMD64
HotSpot (OpenJDK)
IBM/OpenJ9
1.8 - 26
1.8 - 26
macOS 11 - 26 Intel, Apple Hotspot (OpenJDK)
IBM/OpenJ9
1.8 - 26
1.8 - 26
Linux x86
x64/AMD64
HotSpot (OpenJDK)
IBM/OpenJ9
1.8 - 26
1.8 - 26
Linux PPC64LE HotSpot (OpenJDK)
IBM/OpenJ9
1.8 - 26
1.8 - 26
Linux ARMv7
ARMv8
HotSpot (OpenJDK) 1.8 - 26

JProfiler 16 的 GUI 前端需要 Java 25 虚拟机运行。 在 Windows、macOS 和 Linux x64 平台,JProfiler 16 已自带 Java 25 JRE。 attach 命令行工具 jpenable、jpdump 和 jpcontroller 仅需 Java 8 虚拟机即可。