Splunk Observability Cloud 用 Java アプリケーションサーバーのエージェントパスを定義する

このトピックでは、サポートされている Java サーバーに対して、Java アプリケーションをインストルメントするためのエージェントパスを設定する方法について説明します。

Java アプリケーションを Splunk Observability Cloud にインストルメントするには、Splunk Distribution of OpenTelemetry Java からエージェントへのパスを定義する必要があります。以下のセクションでは、サポートされている各サーバーのエージェントパスの設定方法について説明します。

JBoss EAPとWildFly

デプロイメントモードの指示に従ってください。

スタンドアロン・モード

javaagent 引数をスタンドアロン設定ファイルに追加します：

Linux

Linuxでは、standalone.confファイルの最後に以下の行を追加します：

JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/splunk-otel-javaagent.jar"
Windows

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 引数を追加することもできます：

  1. GlassFish Admin Console（ http://localhost:4848 ）を開きます。

  2. Configurations にアクセスし、次に server-config にアクセスします。

  3. JVM Settings を選択します。

  4. JVM Options を選択し、次に Add JVM Option を選択します。

  5. 空欄に splunk-otel-javaagent.jar ファイルへのパスを入力します：

    -javaagent:/path/to/splunk-otel-javaagent.jar

  6. [Save] を選択し、サーバーを再起動します。

注: ドメインディレクトリの domain.xml ファイルに、エージェントの <jmv-options> エントリーが含まれていることを確認してください。

TomcatとTomEE

JVMエージェントへのパスをTomcatまたはTomEEの起動スクリプトに追加します：

Linux

Linuxでは、<tomcat_home>/bin/setenv.sh ファイルに以下の行を追加します：

CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/splunk-otel-javaagent.jar"
Windows

Windowsでは、以下の行を <tomcat_home>\bin\setenv.bat ファイルに追加します：

set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"<Drive>:\path\to\splunk-otel-javaagent.jar"
注: Tomcat を Windows サービスとして実行している場合、setenv.bat スクリプトは使用しません。Tomcat の Windows サービスに Java エージェントを追加するには、管理者として tomcat<version-number>w.exe ユーティリティを実行し、Java Options のリストに -javaagent 引数を追加します。

WebLogic

WebLogicドメインの起動スクリプトに、JVMエージェントへのパスを追加します：

  • Linuxでは、<domain_home>/bin/startWebLogic.shファイルに以下の行を追加します：

    export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/splunk-otel-javaagent.jar"

  • Windows の場合、以下の行を <domain_home>binstartWebLogic.cmd ファイルに追加します。

    set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"<Drive>:\path\to\splunk-otel-javaagent.jar"
注: 管理サーバーインスタンスの場合は、管理コンソールを使用して -javaagent 引数を追加します。

WebSphere Liberty プロファイル

JVMエージェントへのパスをjvm.optionsファイルに追加します：

  1. jvm.options ファイルを開く：- 単一サーバーの場合は、${server.config.dir}/jvm.options ファイルを作成または編集します。：すべてのサーバーの場合は、${wlp.install.dir}/etc/jvm.options ファイルを作成または編集します。

  2. 次の行を追加します：

    -javaagent:/path/to/splunk-otel-javaagent.jar

  3. ファイルを保存し、サーバーを再起動します。

メインフレーム上の WebSphere Liberty サーバーはサポートされていません。

WebSphereトラディショナル

WebSphere Admin Console を開き、以下の手順に従います：

  1. Servers に移動し、次に Server type に移動します。

  2. WebSphere application servers を選択します。

  3. ご希望のサーバーを選択してください。

  4. Java and Process Management に移動し、次に Process Definition に移動します。

  5. Java Virtual Machine を選択します。

  6. Generic JVM arguments フィールドに、Splunk Java エージェントのパスを入力します：

    -javaagent:/path/to/splunk-otel-javaagent.jar

  7. OK を選択します。求められた場合は、メイン構成を保存し、サーバーを再起動します。