Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション 🔗
Splunk Distribution of the OpenTelemetry Collector では、ゼロコードインストルメンテーションによるオートディスカバリーを使用して、Linux 環境で実行されているバックエンドアプリケーションを自動的に検出します。ゼロコードインストルメンテーションで Collector をデプロイすることで、アプリケーションのコードを編集したり、ファイルを設定したりすることなく、アプリケーションを監視し、Splunk Observability Cloud にデータを送信することができます。
Linux のゼロコードインストルメンテーションは、以下のアプリケーションと言語ランタイムを検出し、設定することができます:
Java
Node.js
.NET
Linuxのゼロコードインストルメンテーションの仕組み 🔗
Linux のゼロコードインストルメンテーションは、Splunk Distribution of the OpenTelemetry Collector のモードとして動作します。Linux インストーラ・スクリプトまたはパッケージマネージャを使用して、Collector のゼロコードインストルメンテーションをインストールして有効にします。インストール中に、Collector に検出させたい言語ランタイムのタイプを指定できます。
インストール後、Collector は Linux 環境で実行され、アプリケーションへのリクエストをリッスンします。Collector はアクティビティを検出すると、アプリケーションのランタイムからテレメトリデータを収集し、このデータを Splunk Application Performance Monitoring (APM) に送信します。
要件 🔗
バックエンドの Linux アプリケーションにゼロコードインストルメンテーションを使用するには、以下のコンポーネントが必要です:
systemd
curl
sudo
使用言語のランタイムに固有のコンポーネントもインストールされていることを確認してください:
Javaバージョン8以上とサポートされているライブラリ。詳しくは Javaエージェントの互換性と要件 を参照してください。
Node.jsのバージョン14以上とサポートされているライブラリ。詳しくは Splunk OTel JS の互換性と要件 を参照してください。
.NETバージョン6.0以上とサポートされているライブラリ。詳しくは OpenTelemetry .NET インストルメンテーションの互換性と要件 を参照してください。
.NET のゼロコードインストルメンテーションは、x86_64/AMD64 アーキテクチャでのみサポートされています。
はじめに 🔗
Linuxのゼロコードインストルメンテーションをインストールして使用するには、以下の手順に従ってください:
パッケージをインストールする 🔗
インストーラ・スクリプトを使用して、システムワイド方式でホスト上のサポートされるすべてのアプリケーションに、または systemd
サービスとして実行されるアプリケーションのみに、ゼロコードインストルメンテーションをインストールして有効にすることができます。
インストーラ・スクリプトを使用して、Java のゼロコードインストルメンテーションパッケージをインストールし、システムワイド方式でホスト上のサポートされているすべての Java アプリケーションに対して、または systemd
サービスとして実行されている Javaアプリケーションのみに対して、Java のゼロコードインストルメンテーションを有効にすることができます。
注釈
デフォルトでは、インストーラ・スクリプトを使用すると、すべての言語(Java、Node.js、.NET)でゼロコードインストルメンテーションが有効になります。他の言語のゼロコードインストルメンテーションを無効にするには、インストーラ・スクリプトコマンドに --without-instrumentation-sdk [language]
オプションを追加します。
次の例に示すように、--with-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
注釈
ターゲットホストのログを収集したい場合は、--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
システム全体のゼロコードインストルメンテーションメソッドは、/etc/splunk/zeroconfig/java.conf
に環境変数を自動的に追加します。
インストール時にオプションの deployment.environment
リソース属性を自動的に定義するには、--deployment-environment <env>
オプションを指定してインストーラ・スクリプトを実行します。次の例に示すように、<env>
を希望する属性値、例えば prod
で置き換えます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、サービスが実行されていることを確認し、アプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
次の例に示すように、--with-systemd-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
systemd
のインストルメンテーションは、環境変数を /usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf
に自動的に追加します。
注釈
ターゲットホストのログを収集したい場合は、--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
インストール時にオプションの deployment.environment
リソース属性を自動的に定義するには、--deployment-environment <env>
オプションを指定してインストーラ・スクリプトを実行します。次の例に示すように、<env>
を希望する属性値、例えば prod
で置き換えます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、サービスが実行されていることを確認し、アプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
注釈
まず、ダウンロードしたパッケージを使用して Collector for Linux をインストールします。 を使用して Splunk OpenTelemetry Collector をインストールする必要があります。
Collector をインストールした後、以下の手順に従って、Debian または RPM リポジトリを使用して root
権限でパッケージをインストールしてください:
GitHub Releases ページ から直接
splunk-otel-auto-instrumentation
パッケージをダウンロードするか、Linux ホストのパッケージ・リポジトリに Splunk リポジトリを追加してください。パッケージ・リポジトリの設定方法については Debian または RPM パッケージ・リポジトリ を参照してください。以下のコマンドを実行してパッケージをインストールします。
<path to splunk-otel-auto-instrumentation deb/rpm>
はダウンロードしたパッケージのローカルパスに置き換えてください。sudo dpkg -i <path to splunk-otel-auto-instrumentation deb>
sudo rpm -ivh <path to splunk-otel-auto-instrumentation rpm>
/etc/otel/collector/splunk-otel-collector.conf
ファイルを編集して、SPLUNK_ACCESS_TOKEN
とSPLUNK_REALM
変数を先ほど取得した値に設定します。ファイルが存在しない場合は、/etc/otel/collector/splunk-otel-collector.conf.example
で提供されているサンプルを出発点として使用してください。SPLUNK_ACCESS_TOKEN=<access_token> SPLUNK_REALM=<realm>
コレクタサービスを開始します:
sudo systemctl start splunk-otel-collector
バックエンドアプリケーションの自動ディスカバリーを設定する(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーの設定(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーを設定する を参照してください。
インストーラ・スクリプトを使用すると、システム全体の方法でホスト上のサポートされているすべての Node.js アプリケーションに対して、または systemd
サービスとして実行されている Node.js アプリケーションのみに対して、Node.js のゼロコードインストルメンテーションをインストールして有効にすることができます。
インストーラスクリプトは、npm install
コマンドを使用して Node.js パッケージをインストールします。インストールに npm
へのカスタムパスを指定するには、次の例のように --npm-path <path>
オプションを使用します:
--npm-path /custom/path/to/npm
注釈
デフォルトでは、インストーラ・スクリプトを使用すると、すべての言語(Java、Node.js、.NET)でゼロコードインストルメンテーションが有効になります。他の言語のゼロコードインストルメンテーションを無効にするには、インストーラ・スクリプトコマンドに --without-instrumentation-sdk [language]
オプションを追加します。
パッケージをインストールするには、Collector インストーラスクリプトを --with-instrumentation
オプションを付けて実行します。インストーラスクリプトは、Splunk Distribution of OpenTelemetry JS から Collector と Node.js エージェントをインストールします。Node.js エージェントは、ローカルマシンで Node.js アプリケーションが起動すると自動的にロードされます。
次の例に示すように、--with-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \ sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>注釈
ターゲットホストのログを収集したい場合は、
--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
システム全体のゼロコードインストルメンテーションメソッドは、/etc/splunk/zeroconfig/node.conf
に環境変数を自動的に追加します。
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、コレクターサービスが実行されていることを確認し、Node.jsアプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
次の例に示すように、--with-systemd-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \ sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
systemd
のゼロコードインストルメンテーションは、環境変数を/usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf
に自動的に追加します。注釈
ターゲットホストのログを収集したい場合は、
--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、コレクターサービスが実行されていることを確認し、Node.jsアプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
バックエンドアプリケーションの自動ディスカバリーを設定する(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーの設定(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーを設定する を参照してください。
インストーラ・スクリプトを使用すると、システムワイド方式でホスト上のサポートされているすべての .NET アプリケーションに対して、または systemd
サービスとして実行されている .NET アプリケーションのみに対して、.NET のゼロコードインストルメンテーションをインストールして有効にすることができます。
注釈
デフォルトでは、インストーラ・スクリプトを使用すると、すべての言語(Java、Node.js、.NET)でゼロコードインストルメンテーションが有効になります。他の言語のゼロコードインストルメンテーションを無効にするには、インストーラ・スクリプトコマンドに --without-instrumentation-sdk [language]
オプションを追加します。
次の例に示すように、--with-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
注釈
ターゲットホストのログを収集したい場合は、--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
システム全体のゼロコードインストルメンテーションメソッドは、/etc/splunk/zeroconfig/dotnet.conf
に環境変数を自動的に追加します。
インストール時にオプションの deployment.environment
リソース属性を自動的に定義するには、--deployment-environment <env>
オプションを指定してインストーラ・スクリプトを実行します。次の例に示すように、<env>
を希望する属性値、例えば prod
で置き換えます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、サービスが実行されていることを確認し、アプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
次の例に示すように、--with-systemd-instrumentation
オプションを指定してインストーラ・スクリプトを実行します。<SPLUNK_REALM>
と <SPLUNK_ACCESS_TOKEN>
をそれぞれ Splunk Observability Cloud レルムとトークンに置き換えてください。
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
systemd
のインストルメンテーションは、環境変数を /usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf
に自動的に追加します。
注釈
ターゲットホストのログを収集したい場合は、--with-fluentd
オプションを指定して、Fluentd がCollectorインスタンスにインストールされ、有効になっていることを確認します。
インストール時にオプションの deployment.environment
リソース属性を自動的に定義するには、--deployment-environment <env>
オプションを指定してインストーラ・スクリプトを実行します。次の例に示すように、<env>
を希望する属性値、例えば prod
で置き換えます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
次の例のように、追加オプションを使用して、CPU とメモリ、およびメトリクスの AlwaysOn Profilingを有効にできます:
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --with-systemd-instrumentation --deployment-environment prod \
--realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN> \
--enable-profiler --enable-profiler-memory --enable-metrics
次に、サービスが実行されていることを確認し、アプリケーションを再起動します。Ensure the Collector service is running と アプリケーションを開始する を参照してください。
バックエンドアプリケーションの自動ディスカバリーを設定する(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーの設定(Linuxのみ) を参照してください。
バックエンドアプリケーションの自動ディスカバリーを設定する を参照してください。
Ensure the Collector service is running 🔗
インストールに成功したら、以下のコマンドを実行し、splunk-otel-collector
サービスが実行されていることを確認します:
sudo systemctl status splunk-otel-collector
サービスが起動していない場合は、以下のコマンドで起動または再起動します:
sudo systemctl restart splunk-otel-collector
サービスが開始できない場合は、/etc/otel/collector/splunk-otel-collector.conf
の SPLUNK_REALM
と SPLUNK_ACCESS_TOKEN
が正しいことを確認します。このコマンドでサービスのログを見ることもできます:
sudo journalctl -u splunk-otel-collector
アプリケーションを開始する 🔗
ゼロコードインストルメンテーションを有効にするには、ホストを再起動するか、パッケージをインストールしたホスト上のアプリケーションを手動で起動または再起動する必要があります。ゼロコードインストルメンテーションパッケージを初めてインストールした後、および設定ファイルに変更を加えた場合は常に、ホストまたはアプリケーションを再起動する必要があります。
アプリケーションの実行後、データを検証することができます。Splunk APM で結果を表示する を参照してください。インストルメンテーションの設定もできます。(オプション)インストルメンテーションの設定 を参照してください。
(オプション)インストルメンテーションの設定 🔗
You can configure the Splunk Distribution of the OpenTelemetry Collector to suit your instrumentation needs. In most cases, modifying the basic configuration is enough to get started.
詳しくは、以下のリソースを参照してください:
ゼロコードインストルメンテーションを更新する 🔗
パッケージリポジトリを使うか、Debian や RPM パッケージを使うことで、パッケージをアップグレードできます。
インストーラ・スクリプトを使ってパッケージをインストールした場合、または Debian や RPM のパッケージリポジトリを手動で設定した場合は、プラットフォームに応じて以下のコマンドを実行してください。パッケージのアップグレードには root
権限が必要です。
以下のコマンドを実行します:
sudo apt-get update
sudo apt-get --only-upgrade splunk-otel-auto-instrumentation
/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示されるかもしれません。 上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトのファイルに戻ります。
RPMパッケージ管理システムについては、以下のコマンドを実行します:
yum:
sudo yum upgrade splunk-otel-auto-instrumentation
dnf:
sudo dnf upgrade splunk-otel-auto-instrumentation
zypper:
sudo zypper refresh
sudo zypper update splunk-otel-auto-instrumentation
パッケージをアップグレードしたら、ホスト上のJavaアプリケーションを手動で起動または再起動して、変更を有効にします。
パッケージを手動でアップグレードするには:
GitHub Releases ページ から、ターゲットシステム用の
splunk-auto-auto-instrumentation
Debian パッケージまたは RPM パッケージをダウンロードします。以下のコマンドを実行してパッケージをインストールします。
<path to splunk-otel-auto-instrumentation deb/rpm>
はダウンロードしたパッケージのローカルパスに置き換えてください:
sudo dpkg -i <path to splunk-otel-auto-instrumentation deb>
sudo rpm -Uvh <path to splunk-otel-auto-instrumentation rpm>
Debianパッケージをアップグレードした後、/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示される可能性があります。上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトファイルに戻ります。
Collector と同じパッケージリポジトリを使用してアップグレードすることもできます。詳細は Debian または RPM パッケージ を参照してください。
Node.jsエージェントを提供される最新バージョンに更新するには、まず splunk-otel-auto-instrumentation
パッケージを更新する必要があります。
パッケージリポジトリを使うか、Debian や RPM パッケージを使うことで、パッケージをアップグレードできます。
インストーラ・スクリプトを使ってパッケージをインストールした場合、または Debian や RPM のパッケージリポジトリを手動で設定した場合は、プラットフォームに応じて以下のコマンドを実行してください。パッケージのアップグレードには root
権限が必要です。
以下のコマンドを実行します:
sudo apt-get update
sudo apt-get --only-upgrade splunk-otel-auto-instrumentation
/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示されるかもしれません。 上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトのファイルに戻ります。
RPMパッケージ管理システムについては、以下のコマンドを実行します:
yum:
sudo yum upgrade splunk-otel-auto-instrumentation
dnf:
sudo dnf upgrade splunk-otel-auto-instrumentation
zypper:
sudo zypper refresh
sudo zypper update splunk-otel-auto-instrumentation
パッケージのアップグレードが完了したら、ホスト上のNode.jsアプリケーションを手動で起動または再起動して、変更を有効にします。
パッケージを手動でアップグレードするには:
GitHub Releases ページ から、ターゲットシステム用の
splunk-auto-auto-instrumentation
Debian パッケージまたは RPM パッケージをダウンロードします。以下のコマンドを実行してパッケージをインストールします。
<path to splunk-otel-auto-instrumentation deb/rpm>
はダウンロードしたパッケージのローカルパスに置き換えてください:
sudo dpkg -i <path to splunk-otel-auto-instrumentation deb>
sudo rpm -Uvh <path to splunk-otel-auto-instrumentation rpm>
Debianパッケージをアップグレードした後、/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示される可能性があります。上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトファイルに戻ります。
Collector と同じパッケージリポジトリを使用してアップグレードすることもできます。詳細は Debian または RPM パッケージ を参照してください。
splunk-otel-auto-instrumentation
パッケージを更新したら、以下のコマンドを実行します:
cd /usr/lib/splunk-instrumentation/splunk-otel-js && \
sudo npm install /usr/lib/splunk-instrumentation/splunk-otel-js.tgz
デフォルトのゼロコードインストルメンテーション設定では、Node.js エージェントが /usr/lib/splunk-instrumentation/splunk-otel-js
パス下にインストールされていることを想定しています。
Node.jsエージェントが別のパスにインストールされている場合は、NODE_OPTIONS
環境変数のパスを、システム全体サービスの場合は /etc/splunk/zeroconfig/node.conf
で、 systemd
サービスの場合は /usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf
で、手動で更新してください。例:
NODE_OPTIONS=-r /custom/nodejs/install/path/@splunk/otel/instrument
パッケージリポジトリを使うか、Debian や RPM パッケージを使うことで、パッケージをアップグレードできます。
インストーラ・スクリプトを使ってパッケージをインストールした場合、または Debian や RPM のパッケージリポジトリを手動で設定した場合は、プラットフォームに応じて以下のコマンドを実行してください。パッケージのアップグレードには root
権限が必要です。
以下のコマンドを実行します:
sudo apt-get update
sudo apt-get --only-upgrade splunk-otel-auto-instrumentation
/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示されるかもしれません。 上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトのファイルに戻ります。
RPMパッケージ管理システムについては、以下のコマンドを実行します:
yum:
sudo yum upgrade splunk-otel-auto-instrumentation
dnf:
sudo dnf upgrade splunk-otel-auto-instrumentation
zypper:
sudo zypper refresh
sudo zypper update splunk-otel-auto-instrumentation
パッケージをアップグレードしたら、ホスト上の.NETアプリケーションを手動で起動または再起動して、変更を有効にします。
パッケージを手動でアップグレードするには:
GitHub Releases ページ から、ターゲットシステム用の
splunk-auto-auto-instrumentation
Debian パッケージまたは RPM パッケージをダウンロードします。以下のコマンドを実行してパッケージをインストールします。
<path to splunk-otel-auto-instrumentation deb/rpm>
はダウンロードしたパッケージのローカルパスに置き換えてください:
sudo dpkg -i <path to splunk-otel-auto-instrumentation deb>
sudo rpm -Uvh <path to splunk-otel-auto-instrumentation rpm>
Debianパッケージをアップグレードした後、/etc/splunk/zeroconfig/
にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示される可能性があります。上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトファイルに戻ります。
Collector と同じパッケージリポジトリを使用してアップグレードすることもできます。詳細は Debian または RPM パッケージ を参照してください。
トラブルシューティング 🔗
アプリケーションのインストルメンテーション時に発生する一般的なエラーのトラブルシューティングについては、以下のトラブルシューティングガイドを参照してください:
Splunk APM で結果を表示する 🔗
ゼロコードインストルメンテーションを有効にした後、データが Splunk Observability Cloud に流れていることを確認します。データがSplunk APMに取り込まれていることを確認する を参照してください。