Resin
JVMオプションの追加
Resinを使用するアプリケーションサーバー環境でJVMオプションを追加する方法を確認してください。Javaバージョンによって適用するJVMオプションが異なる場合があります。ユーザーの環境に合わせたJVMオプションを適用してください。オプションを適用して、アプリケーションサーバーを再起動してください。
-
オプション1: _resin.properties_ファイルに
jvm_args
属性を使ってjavaagent
引数を追加してください。 -
オプション2:
conf/resin.conf
またはconf/resin.xml
ファイルに<jvm-args>
セクションを追加して-javaagent
引数を設定してください。
-
アプリケーションサーバーのログファイルとエージェントのログファイルを使用して、エージェントが正常に動作していることとエラーが発生していないことを確認してください。ログファイルの場所については、以下を確認してください。
- エージェント:
$WHATAP_HOME
/logs/whatap-{SERVER_NAME}
-{DATE}
.log - RESIN 4.x: $RESIN_HOME/log/jvm-app-#.log
- エージェント:
-
エージェントが正常に動作しないか、エラーが発生した場合は次の文書を確認してください。
Java 6 ~ Java 8バージョン
jvm_args : -javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar
<jvmarg>-javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar</jvm-arg>
Java 9 ~ Java 15バージョン
jvm_args : -javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar -Djdk.attach.allowAttachSelf=true
<jvmarg>-javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar</jvm-arg>
<jvmarg>-Djdk.attach.allowAttachSelf=true</jvm-arg>
Java 16バージョン以降
jvm_args : -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
<jvmarg>-javaagent:{WHATAP_HOME}/whatap.agent-X.Y.Z.jar</jvm-arg>
<jvmarg>-Djdk.attach.allowAttachSelf=true</jvm-arg>
<jvmarg>--add-opens=java.base/java.lang=ALL-UNNAMED</jvm-arg> <!-- Java 17 or later -->
<jvmarg>--add-opens=jdk.attach/sun.tools.attach=ALL-UNNAMED</jvm-arg>
ヒープヒストグラム照会
WhaTapのJavaモニタリングでは、JVMメモリのヒープ占有オブジェクト現況(ヒープメモリ上のオブジェクト別サイズ)を照会できる機能を標準として提供します。 アプリケーション > インスタンスパフォーマンス分析メニューからヒープヒストグラムタブを選択してください。
Java 6~8バージョンでは、JVMオプションなしで標準対応しますが、一部のJavaバージョンによっては次のようにJVMオプションを適用する必要があります。
-
Java 9 ~ Java 15バージョン
-Djdk.attach.allowAttachSelf=true
examplejava -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-UNNAMEDexamplejava -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には対応していません。
モニタリングの開始
すべての設定を完了してからアプリケーションサーバーを再起動すると、エージェントが情報収集を開始します。次の文書を確認してください。