Java Agentの適用方法

対象アプリケーションサーバへJava Agentを適用するためには、JVM起動引数にSheltyのJava Agent用の引数を追加し、対象のアプリケーションサーバの再起動を行ってください。

但し、アプリケーションサーバの種類やバージョン、開発環境によっては、SheltyのJava Agent用の引数に加えて、追加の引数指定が必要となります。

【表　アプリケーションサーバ毎の追加引数の有無】

-javaagent:{JavaAgent のパス}/java/javaagent.jar=instance={SheltyでのInstance番号}

-javaagent:{JavaAgentのパス}/java/javaagent.jar=instance_key={Agent導入画面で指定したInstanceキー}

※「SheltyでのInstance番号」とは、Agent導入画面のJava(AP+RT)の行の「Instance」欄に表示されている数字です。

(例) Linux環境でデフォルトパスにAgent導入している場合

-javaagent:/opt/iim/shelty/java/javaagent.jar=instance=1

(例) Windows環境でE:\iimSheltyフォルダにAgent導入している場合

-javaagent:E:\iimShelty\module\shelty\java\javaagent.jar=instance=1

なお、JVM引数のサンプルはSheltyのAgent導入画面から確認することが可能です。

Agent導入画面で保存ボタンをクリックすると、Java(AP+RT)の行の備考に「適用手順を表示」のリンクが表示されます。「適用手順を表示」をクリックしてダウンロードされる手順書を参照してください。

【図　Agent導入(Java(AP+RT))】

【図　適用手順を表示(Java(AP+RT))】

同一スクリプトで複数のJVMを起動している場合、個々のInstanceキーを設定することができません。その場合は、下記のようにinstance_envに環境変数を設定することで個々のインスタンスに対応します。

事前に環境変数に格納されるインスタンス名を導入画面のInstanceキーで設定しておく必要があります。

-javaagent:{JavaAgentのパス}/java/javaagent.jar=instance_env={環境変数}

現在サポートされている環境変数は下記の通りです。

【表　 instance_env で使用可能な環境変数】

！注意
Interstage、JBoss EAP、Websphereの場合は下記の追加設定を行ってください。

JVM引数の追加によりアプリケーションサーバの起動に問題が生じた場合は、以下を参照してください。