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 では、デスクトップファイルをランチャーのサイドバーにドラッグすることで、恒久的なランチャーアイテムを作成できます。

プロファイリングエージェントをリモートマシンに配布する

JProfiler は 2 つのパートで構成されています。1 つはデスクトップ UI とスナップショットを操作するコマンドラインユーティリティ、 もう 1 つはプロファイリングエージェントとプロファイル対象 JVM を制御するコマンドラインユーティリティです。 Web サイトからダウンロードできるインストーラーやアーカイブには、両方のパートが含まれています。

ただし、リモートプロファイリングの場合は、リモート側にプロファイリングエージェントのみをインストールすれば十分です。 JProfiler ディストリビューションのアーカイブをリモートマシンで展開するだけでも構いませんが、 デプロイ自動化時など、必要なファイル数を最小限に抑えたい場合もあるでしょう。 また、プロファイリングエージェントは自由に再配布可能なので、アプリケーションと一緒に配布したり、 顧客マシンにインストールしてトラブルシューティングに利用することもできます。

プロファイリングエージェントのみの最小パッケージを取得するには、リモート統合ウィザードで適切なエージェントアーカイブのダウンロードリンクや、 すべてのサポートプラットフォーム向けエージェントアーカイブのダウンロードページが表示されます。 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 

単一エージェントアーカイブのダウンロード URL のフォーマットは次の通りです。

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

ここで platformbin ディレクトリ内のエージェントディレクトリ名に対応し、 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_0.tar.gz 

エージェントアーカイブには、必要なネイティブエージェントライブラリとともに jpenable jpdump jpcontroller の各実行ファイルが含まれています。アーカイブ内の実行ファイルおよびプロファイリングエージェントは、 最低でも Java 8 がインストールされていれば動作します。

リモートマシンでエージェントアーカイブを展開した後に表示されるサブディレクトリは下記の通りです。 これらは、各ターゲットプラットフォームにおける JProfiler フルインストールのサブセットとなっています。

抽出後のトップレベルディレクトリ.install4jbin<platform-64><platform-32>libエージェントJARファイルとヘルパー実行ファイル64ビットJVM用のネイティブライブラリ32ビットJVM用のネイティブライブラリアタッチ機能のサポートライブラリランチャー用のランタイムライブラリ

サポートされているプラットフォーム

JProfiler は JVM のネイティブプロファイリングインターフェース(JVMTI)を利用しているため、プロファイリングエージェントはネイティブライブラリです。

JProfiler 16 は、以下のプラットフォームでプロファイリングをサポートしています。

OS アーキテクチャ サポートされている 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 が必要です。 Windows、macOS、Linux x64 向けには、この目的のために Java 25 JRE が JProfiler 16 に同梱されています。 attach コマンドラインツール(jpenable, jpdump, jpcontroller)は、Java 8 VM さえあれば動作します。