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 ）を開きます。
Configurations にアクセスし、次に server-config にアクセスします。
JVM Settings を選択します。
JVM Options を選択し、次に Add JVM Option を選択します。
空欄に 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"

注釈

TomcatをWindowsサービスとして実行する場合、setenv.batスクリプトは使用しません。TomcatのWindowsサービスにJavaエージェントを追加するには、管理者としてtomcat<バージョン番号>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></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 を選択します。メイン構成を保存し、サーバーを再起動します。

このページは 2024年09月03日に最終更新されました。

Related Topics