JEUS

JVMオプションの追加

JEUSアプリケーションサーバー環境でJavaモニタリングエージェントを効果的に使用するために必要なJVMオプションを追加する方法を案内します。

JEUSバージョンによる開始オプションの設定ファイルのパスを参照して、-javaagentオプションを追加してください。

JEUS 7
JEUS 6

$JEUS_HOME/domains/jeus_domain/config.xml
<domain>
    <servers>
        <server>
            <name>server1</name>
            <jvm-config>
                <jvm-option>
                    -Xmx1024m -XX:MaxPermSize=128m
                    -javaagent:/whatap/whatap.agent-X.Y.Z.jar
                </jvm-option>
            </jvm-config>
        </server>
    </servers>
    ...
</domain>

$JEUS_HOME/config/$hostname/JEUSMain.xml
<node>
    <name>node01</name>
    <engine-container1>
        <name>container1</name>
        ...
        <command-option>-Xmx1024m -XX:MaxPermSize=128m
            -javaagent:/whatap/whatap.agent-#.#.#.jar
        </command-option>
        ...
    </engine-container1>
</node>

アプリケーションサーバーを再起動します。
```
jdown && jboot
```
アプリケーションサーバーのログファイルとエージェントのログファイルを確認して、エージェントが正常に動作しているか、エラーが発生していないかを確認してください。ログファイルの場所については、以下を参照してください。
- エージェント：$WHATAP_HOME/logs/whatap-{SERVER_NAME}-{DATE}.log
- JEUS 7: $JEUS_HOME/domains/$HOST_NAME/servers/$NODE_NAME/logs/JeusServer.log
- JEUS 6: $JEUS_HOME/logs/$NODE_NAME/JeusServer.log
エージェントがアプリケーションサーバーの種類とサービスコンテナー名を認識していることを確認してください。

ノート

WhaTapモニタリングサービスにログインし、プロジェクトを選択してください。アプリケーション > インスタンスパフォーマンス分析メニューを選択し、実行環境変数タブを選択してください。whatap.nameとwhatap.type項目を確認してください。whatap.name項目の最後の要素は、コンテナ名にしてください。whatap.type項目には、アプリケーションサーバーの種類を指定してください。

Boot Environment

ノート

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には対応していません。

JVMオプションの追加​

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

JVMオプションの追加

ヒープヒストグラム照会