リモートJMXによるネイティブ実行可能ファイルのビルドおよび実行
GraalVMネイティブ・イメージでビルドされた実行可能ファイルでは、Java Management Extensions (JMX)を使用したリモート管理が可能です。
ノート: この機能は試験段階です。
このガイドでは、JMXを使用して、このようなネイティブ実行可能ファイルをビルド、実行および操作するために必要なステップについて説明します。また、カスタム管理対象Bean (MBean)をJMXサーバーに登録する方法と、そのネイティブ・イメージとの連携に必要な追加ステップも示します。
現在サポートされている機能と制限
クライアントからリモートのMBeanサーバーへのJMX接続がサポートされています。クライアント、サーバー、またはその両方がネイティブ実行可能ファイルである場合があります。MXBeanおよび標準ユーザー定義のMBeanのみがサポートされています。動的およびモデルMBeanは、管理インタフェースが実行時に定義されるためサポートされていません。MXBeanのリモート管理はサポートされていますが、ネイティブ・イメージですべてのプラットフォームMXBean機能が実装されたり、適用できるわけではありません。また、標準のMBeanを定義して使用するには、メタデータ構成を指定する必要があります。これについては、このガイドで詳しく説明します。
ステップ1: デモ・アプリケーションの作成
demoという名前のディレクトリにデモ・アプリケーションを作成します。作業ディレクトリをそこに変更し、そのディレクトリからコマンドを実行します。
次のコードをSimpleJmx.javaという名前のファイルに保存します。main()
メソッドは、カスタムMBeanを登録してから無限ループするため、VisualVMを使用してプロセスを検査する時間があります。
import javax.management.MBeanServer;
import javax.management.ObjectName;
import java.lang.management.ManagementFactory;
public class SimpleJmx {
public static void main(String args[]) throws Exception {
ObjectName objectName = new ObjectName("com.jmx.test.basic:name=simple");
Simple simple = new Simple();
simple.setName("someName");
MBeanServer server = ManagementFactory.getPlatformMBeanServer();
server.registerMBean(simple, objectName);
while (true) {
Thread.sleep(1000);
System.out.println("JMX server running...");
}
}
public static interface SimpleMBean {
String getName();
void setName(String name);
String print();
}
static class Simple implements SimpleMBean {
private String name;
@Override
public String getName() {
return name;
}
@Override
public void setName(String name) {
this.name = name;
}
@Override
public String print() {
return "Print output " + name;
}
}
}
ステップ2: Javaバイトコードへのコンパイル
-
GraalVM JDKがインストール済であることを確認します。最も簡単に始めるには、SDKMAN!を使用します。その他のインストール・オプションについては、「ダウンロード」セクションを参照してください。
-
GraalVM JDKを使用してJavaファイルをコンパイルします:
$JAVA_HOME/bin/javac SimpleJmx.java
これにより、SimpleJmx.class、SimpleJmx$Simple.classおよびSimpleJmx$SimpleMBean.classファイルが作成されます。
ステップ3: 動的プロキシ構成の作成
JMXは、Javaの動的機能である動的プロキシを使用して、MBeanにアクセスします。実行時にカスタムSimpleMBean
と対話できるようにするには、MBeanインタフェースの追加の動的プロキシ構成をネイティブ・イメージに提供する必要があります。そのためには、次の内容を含むproxy-config.JSONという名前のJSONファイルを作成します:
[
{ "interfaces": [ "SimpleJmx$SimpleMBean"] }
]
次のステップで、このJSONファイルをnative-image
ビルダーに渡します。
ステップ4: JMXサポートを使用したネイティブ実行可能ファイルのビルド
VMモニタリングを有効にしてネイティブ実行可能ファイルをビルドします:
$JAVA_HOME/bin/native-image --enable-monitoring=jmxserver,jvmstat -H:DynamicProxyConfigurationFiles=proxy-config.json SimpleJmx
--enable-monitoring=jmxserver
オプションは、着信接続の受入れを可能にするJMXサーバー機能を有効にします。--enable-monitoring=jmxclient
オプションは、送信接続を可能にするJMXクライアント機能を有効にします。両方の機能をカンマ区切りで一緒に使用できます(例: --enable-monitoring=jmxserver,jmxclient
)。VisualVMおよびその他のJVMによる検出を有効にする場合は、jvmstat
オプションも含める必要があります(--enable-monitoring=jmxserver,jmxclient,jvmstat
)。
ステップ5: JMXプロパティを使用した実行可能ファイルの実行
次に、JMXプロパティを使用してネイティブ実行可能ファイルを実行します:
./simplejmx -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.port=9996 -Dcom.sun.management.jmxremote.ssl=false
これにより、パスワード認証またはポート9996
を使用したSSLを使用せずに、単純なJMXサーバーとしてアプリケーションが起動されます。このガイドに示す、通常のすべてのプロパティを適用するようにJMXを構成できますが、この例では、簡略化のために基本的な構成を使用します。
ステップ6: VisualVMを使用した検査
-
VisualVMを起動して、マネージドBeanをわかりやすい方法で表示します。VisualVMは個別に出荷され、最初に
gu
を使用してGraalVMに追加してから起動する必要があることに注意してください:$JAVA_HOME/bin/gu install visualvm $JAVA_HOME/bin/visualvm
-
"VisualVM-MBeans"プラグインがインストールされていることを確認してください(「ツール」→「プラグイン」→「使用可能なプラグイン」→VisualVM-MBeansを選択し、「インストール」をクリックします)。
-
「アプリケーション」タブに移動し、SimpleJmxプロセスを選択します。そこから「MBean」タブを選択できます。
-
「MBean」タブでは、以前に作成したカスタムMBeanを調べて、操作を実行できます。
結論として、ネイティブ・イメージでは、JMXを使用したリモート管理がサポートされるようになりました。ユーザーは、ネイティブ実行可能ファイルでJMXエージェントを有効にして、リモート・システムで実行されているクライアント・アプリケーションをモニターできます。