Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud 用 Java アプリケーションのインストルメンテーション » Splunk Observability Cloud 用 Java アプリケーションサーバーのエージェントパスを定義する

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"

ドメインモード 🔗

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の起動スクリプトに追加します:

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"

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ファイルに追加します:

  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 を選択します。メイン構成を保存し、サーバーを再起動します。

This page was last updated on 2024年06月25日.