本文へスキップ

WebSphere

JVMオプションの追加​

WebSphereアプリケーションサーバー環境でJavaモニタリングエージェントを効果的に使用するために必要なJVMオプションを追加する方法を案内します。JVMオプションを追加するには、管理コンソール(Admin console)に接続してください。

  1. ウェブブラウザで管理コンソールにログインしてください。

  2. Environment > Virtual Hosts > default host > Host Aliases項目を選択し、エージェントをインストールするサーバーのポート番号を確認してください。

    WebSphere port

  3. Servers > Server Types > Websphere application servers項目に移動し、エージェントをインストールするサーバーを選択してください。

    WebSpherer application servers

  4. 選択したサーバー画面からConfigurationタブを選択し、Server InfrastructureセクションのJava and Process Management > Process definitionメニューを選択してください。

    WebSphere Configuration

  5. 右側のメニューからAdditional Properties > Java Virtual Machineメニューを選択してください。

  6. ConfigurationタブからGeneric JVM argumentsテキストボックスに-javaagentと-Dwhatap.portを追加してください。

    -javaagent:/whatap/whatap.agent-X.Y.Z.jar
    -Dwhatap.port={ポート番号} ## 2番 項目 ポート番号 ##

    Add JVM arguments

ノート

Java 17 以降では、reflectionに関する次のオプションを追加します。


--add-opens=java.base/java.lang=ALL-UNNAMED

ヒープヒストグラム照会​

WhaTapのJavaモニタリングでは、JVMメモリのヒープ占有オブジェクト現況(ヒープメモリ上のオブジェクト別サイズ)を照会できる機能を標準として提供します。 アプリケーション > インスタンスパフォーマンス分析メニューからヒープヒストグラムタブを選択してください。

Java 6~8バージョンでは、JVMオプションなしで標準対応しますが、一部のJavaバージョンによっては次のようにJVMオプションを適用する必要があります。

  • Java 9 ~ Java 15バージョン

    -Djdk.attach.allowAttachSelf=true
    example
    java -javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar -Djdk.attach.allowAttachSelf=true -jar {application.jar}

  • Java 16バージョン以降

    -Djdk.attach.allowAttachSelf=true
    --add-opens=jdk.attach/sun.tools.attach=ALL-UNNAMED
    example
    java -javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar -Djdk.attach.allowAttachSelf=true --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=jdk.attach/sun.tools.attach=ALL-UNNAMED -jar {application.jar}
ノート

Java 5以前の旧バージョン、IBM Javaには対応していません。

モニタリングの開始​

すべての設定を完了してからアプリケーションサーバーを再起動すると、エージェントが情報収集を開始します。次の文書を確認してください。