Splunk Observability Cloud 用 Java アプリケーションサーバーのエージェントパスを定義する 🔗
Java アプリケーションを Splunk Observability Cloud でインストルメンテーションするには、Splunk Distribution of OpenTelemetry Java からエージェントへのパスを定義する必要があります。以下のセクションでは、サポートされている各サーバーのエージェントパスの設定方法について説明します。
JBoss EAPとWildFly 🔗
デプロイメントモードの指示に従ってください。
スタンドアロン・モード 🔗
javaagent
引数をスタンドアロン設定ファイルに追加します:
Linuxでは、standalone.confファイルの最後に以下の行を追加します:
JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/splunk-otel-javaagent.jar"
Windowsでは、standalone.conf.batファイルの最後に以下の行を追加します:
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:<Drive>:\path\to\splunk-otel-javaagent.jar"
ドメインモード 🔗
domain.xml ファイルを編集し、server-groups.server-group.jvm.jvm-options
の下に以下のオプションを追加します:
<option value="-javaagent:/path/to/splunk-otel-javaagent.jar"/>
詳細については、Red Hat のドキュメント を参照してください。
注釈
各サーバーグループレベルにJavaエージェントをインストールしてください。
Jetty 🔗
-javaagent
引数を使用して、JVMエージェントへのパスを追加します:
java -javaagent:/path/to/splunk-otel-javaagent.jar -jar start.jar
あるいは、jetty.shまたはstart.iniファイルに -javaagent
引数を追加することもできます:
jetty.shファイルを使ってJettyを起動する場合は、<jetty_home>/bin/jetty.shファイルに以下の行を追加します:
JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/splunk-otel-javaagent.jar"
start.iniファイルを使用してJVM引数を定義する場合は、
--exec
オプションの下にjavaagent
引数を追加します:#=========================================================== # Sample Jetty start.ini file #----------------------------------------------------------- --exec -javaagent:/path/to/splunk-otel-javaagent.jar
Glassfish と Payara 🔗
asadminコマンドラインツールを使用して、JVMエージェントへのパスを設定に追加します:
Linuxでは、以下のコマンドを入力します:
<server_install_dir>/bin/asadmin create-jvm-options "-javaagent\:/path/to/splunk-otel-javaagent.jar"
Windowsでは、以下のコマンドを入力します:
<server_install_dir>\bin\asadmin.bat create-jvm-options '-javaagent\:<Drive>\:\\path\\to\\splunk-otel-javaagent.jar'
GlassfishまたはPayaraアドミンコンソールから -javaagent
引数を追加することもできます:
GlassFish Admin Console(
http://localhost:4848
)を開きます。にアクセスし、次に にアクセスします。
を選択します。
を選択し、次に を選択します。
空欄に splunk-otel-javaagent.jar ファイルへのパスを入力します:
-javaagent:/path/to/splunk-otel-javaagent.jar
Save を選択し、サーバーを再起動します。
注釈
ドメインディレクトリの domain.xml ファイルに、エージェントの <jmv-options>
エントリーが含まれていることを確認してください。
TomcatとTomEE 🔗
JVMエージェントへのパスをTomcatまたはTomEEの起動スクリプトに追加します:
On Linux, add the following line to the <tomcat_home>/bin/setenv.sh
file:
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/splunk-otel-javaagent.jar"
On Windows, add the following line to the <tomcat_home>\bin\setenv.bat
file:
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"<Drive>:\path\to\splunk-otel-javaagent.jar"
注釈
When running Tomcat as a Windows service, the setenv.bat script is not used. To add the Java agent to your Tomcat Windows service, run the tomcat<version-number>w.exe utility as an administrator, then add the -javaagent
argument to the list of Java Options.
WebLogic 🔗
WebLogicドメインの起動スクリプトに、JVMエージェントへのパスを追加します:
Linuxでは、<domain_home>/bin/startWebLogic.shファイルに以下の行を追加します:
export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/splunk-otel-javaagent.jar"
Windows の場合、以下の行を <domain_home></bin></bin></startWebLogic.cmd ファイルに追加します:
set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"<Drive>:\path\to\splunk-otel-javaagent.jar"
注釈
管理サーバー・インスタンスの場合は、管理コンソールを使用して -javaagent
引数を追加します。
WebSphere Liberty プロファイル 🔗
JVMエージェントへのパスをjvm.optionsファイルに追加します:
jvm.optionsファイルを開く:- 単一サーバーの場合は、
${server.config.dir}/jvm.options
ファイルを作成または編集します。- すべてのサーバーの場合は、${wlp.install.dir}/etc/jvm.options
ファイルを作成または編集します。次の行を追加します:
-javaagent:/path/to/splunk-otel-javaagent.jar
ファイルを保存し、サーバーを再起動します。
メインフレーム上の WebSphere Liberty サーバーはサポートされていません。
WebSphereトラディショナル 🔗
WebSphere Admin Console を開き、以下の手順に従います:
Servers に移動し、次に Server type に移動します。
WebSphere application servers を選択します。
ご希望のサーバーを選択してください。
Java and Process Management に移動し、次に Process Definition に移動します。
Java Virtual Machine を選択します。
Generic JVM arguments フィールドに、Splunk Java エージェントのパスを入力します:
-javaagent:/path/to/splunk-otel-javaagent.jar
OK を選択します。メイン構成を保存し、サーバーを再起動します。