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 上,您可以将桌面文件拖到启动器侧边栏以创建永久启动项。

将分析 Agent 分发到远程机器

JProfiler 由两部分组成:一方面是桌面 UI 以及对快照进行操作的命令行工具;另一方面是分析 Agent 以及控制被分析 JVM 的命令行工具。 您从网站下载的安装程序和归档包包含这两部分。

但对于远程分析,您只需在远程端安装分析 Agent。 虽然您可以直接在远程机器上解压包含 JProfiler 发行版的归档包,但您可能希望限制所需文件的数量,尤其是在自动化部署时。 此外,分析 Agent 可以自由再分发,因此您可以将其随应用程序一起发布,或安装到客户机器上用于故障排查。

要获取包含分析 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.2

单个 Agent 归档包下载 URL 的格式为

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

其中 platform 对应 bin 目录中的 Agent 目录名, extension 在 Windows 上为 zip,在 macOS 上为 .tgz, 在 Linux/Unix 上为 .tar.gz。对于 Linux,x86 和 x64 归为一组,因此 Linux x64 的 URL 为

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

Agent 归档包包含所需的本地 Agent 库以及 jpenable jpdump jpcontroller 可执行文件。归档包中的可执行文件以及分析 Agent 最低仅需要 Java 8。

在远程机器上解压 Agent 归档包后,您看到的子目录说明如下。 它们是相应目标平台上完整 JProfiler 安装的子集。

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

支持的平台

由于 JProfiler 使用 JVM 的本地分析接口(JVMTI),其分析 Agent 是一个本地库。

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 VM 才能运行。为此,JProfiler 16 在 Windows、macOS 和 Linux x64 上捆绑了 Java 25 JRE。 attach 命令行工具 jpenable、jpdump 和 jpcontroller 仅需要 Java 8 VM。