Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » App とサービスのオートディスカバリー » Linux用のオートディスカバリーとゼロコードインストルメンテーション » Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション

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エージェントの互換性と要件 を参照してください。

はじめに 🔗

Linuxのゼロコードインストルメンテーションをインストールして使用するには、以下の手順に従ってください:

  1. パッケージをインストールする

  2. Ensure the Collector service is running

  3. Splunk APM で結果を表示する

パッケージをインストールする 🔗

インストーラ・スクリプトを使用して、システムワイド方式でホスト上のサポートされるすべてのアプリケーションに、または 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アプリケーションを開始する を参照してください。

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.confSPLUNK_REALMSPLUNK_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/ にある設定ファイルを保持するか上書きするかを尋ねるプロンプトが表示されるかもしれません。 上書きを選択した場合、設定ファイルはアップグレードされたパッケージが提供するデフォルトのファイルに戻ります。

トラブルシューティング 🔗

アプリケーションのインストルメンテーション時に発生する一般的なエラーのトラブルシューティングについては、以下のトラブルシューティングガイドを参照してください:

Splunk APM で結果を表示する 🔗

ゼロコードインストルメンテーションを有効にした後、データが Splunk Observability Cloud に流れていることを確認します。データがSplunk APMに取り込まれていることを確認する を参照してください。

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