Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector for Linux を使い始める » インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。 🔗

Splunk Distribution of the OpenTelemetry Collector for Linuxは、すべてのデータタイプに対して統合された収集と転送を提供するパッケージです。

以下のいずれかの方法でパッケージをインストールします:

対応バージョン 🔗

Collector は以下のLinuxディストリビューションとバージョンをサポートしています:

  • Amazon Linux: 2, 2023.Fluentdによるログ収集は、現在Amazon Linux 2023ではサポートされていません。

  • CentOS: 7, 8, 9

  • Red Hat: 7, 8, 9

  • Oracle: 8, 9

  • Debian: 11, 12

  • SUSE: 12, 15 バージョン 0.34.0 以上。Fluentd によるログ収集は現在サポートされていません。

  • Ubuntu:16.04、18.04、20.04、22.04、24.04

  • Rocky Linux: 8, 9

含まれるパッケージ 🔗

インストーラ・スクリプトは、これらの要素をデプロイし、設定します:

インストーラ・スクリプトを使用してCollectorをインストールする 🔗

インストーラ・スクリプトを使用してCollectorパッケージをインストールするには、以下の手順に従ってください:

  1. systemdcurlsudo がインストールされていることを確認します。

  2. このコマンドを使用して、インストーラ・スクリプトをダウンロードして実行します。

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh;
sudo sh /tmp/splunk-otel-collector.sh --realm $SPLUNK_REALM --memory $SPLUNK_MEMORY_TOTAL_MIB -- $SPLUNK_ACCESS_TOKEN

以下の変数を環境に合わせて置き換えてください:

  • SPLUNK_REALM:これはデータを送信するレルムです。デフォルトは us0 です。Splunk レルムを見つけるには、レルムについての注意 を参照してください。

  • SPLUNK_MEMORY_TOTAL_MIB:メビバイト(MiB)単位で割り当てられたメモリの合計。例えば、512 は512MiB (500 x 2^20バイト)のメモリを割り当てます。

  • SPLUNK_ACCESS_TOKEN:データ取り込みリクエストを認証するための、base64 エンコードされたアクセストークンです。Splunk Observability Cloudを使用した組織のアクセストークンの作成および管理 を参照してください。

メモリ割り当てを設定する 🔗

メモリ割り当てを設定するには、--memory パラメータを変更します。デフォルトでは、このパラメータは512MiB、つまり500×2^20バイトのメモリに設定されています。次の例に示すように、より多くのメモリを割り当てるには、この設定を増やします。

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh;
sudo sh /tmp/splunk-otel-collector.sh --realm $SPLUNK_REALM --memory $SPLUNK_MEMORY_TOTAL_MIB \
    -- $SPLUNK_ACCESS_TOKEN

プロキシ設定を構成する 🔗

OpenTelemetry Collector をインストールして実行するためのプロキシ設定を行うには、Collectorのプロキシ設定を構成する を参照してください。

設定されたレポを使用する 🔗

デフォルトでは、apt/yum/zypperのレポ定義ファイルが作成され、それぞれ https://splunk.jfrog.io/splunkhttps://packages.treasuredata.com からパッケージとFluentdのdeb/rpmパッケージをダウンロードします。

これらの手順を省略し、splunk-otel-collector および td-agent deb/rpm パッケージを提供するターゲットシステム上の設定済みレポを使用するには、--skip-collector-repo または --skip-fluentd-repo オプションを指定します。例:

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
sudo sh /tmp/splunk-otel-collector.sh --realm $SPLUNK_REALM --skip-collector-repo --skip-fluentd-repo \
 -- $SPLUNK_ACCESS_TOKEN

バックエンドアプリケーションの自動ディスカバリーを設定する 🔗

また、Collectorのインストールと一緒に、Java、Node.js、.NETアプリケーションを自動的にインストルメンテーションすることもできます。自動ディスカバリーにより、各バックエンドアプリケーションにレシーバーを設定する必要がなくなります。インストール手順については Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション を参照してください。

APM インストルメンテーションの詳細については、次を参照してください:

DockerのあるCollector for Linux 🔗

Dockerを使用してホストでCollectorをインストールする 🔗

Dockerを使用してCollectorインスタンスをホストにインストールしている場合は、デーモンとの接続を確立するためにクライアントを設定する必要があります。DockerのインストールとCollectorのデプロイ方法に応じて、以下のオプションのいずれかを試してください:

  1. デーモンがドメインソケット(たとえば /var/run/docker.sock )をリッスンしている場合、Collectorサービスまたは実行ファイルに適切な権限とアクセスが必要です。システムで設定されているDockerグループに splunk-otel-collector ユーザーを追加します:

$ usermod -aG docker splunk-otel-collector
  1. quay.io/signalfx/splunk-otel-collector 画像を使用する場合は、デフォルトのコンテナユーザーを、システムで設定されている必要なグループに追加し、ドメインソケットをバインドしてマウントします:

$ docker run -v /var/run/docker.sock:/var/run/docker.sock:ro --group-add $(stat -c '%g' /var/run/docker.sock) quay.io/signalfx/splunk-otel-collector:latest <...>

# or if specifying the user:group directly
$ docker run -v /var/run/docker.sock:/var/run/docker.sock:ro --user "splunk-otel-collector:$(stat -c '%g' /var/run/docker.sock)" quay.io/signalfx/splunk-otel-collector:latest <...>

コンテナで自動ディスカバリーを使用する 🔗

CollectorインスタンスがDockerコンテナで実行され、検出ターゲットもコンテナである場合、Collectorコンテナを起動するときにDockerソケットを共有する必要があります:

$ docker run -v /var/run/docker.sock:/var/run/docker.sock:ro --group-add <socket_gid>

ホストバインディングを使用するには、次のコマンドを実行します:

--set=splunk.discovery.extensions.docker_observer.config.use_host_bindings=true

Collector for Linuxインストーラ・スクリプトのオプション 🔗

Linuxインストーラ・スクリプトは、Collector、バックエンドサービスのゼロコードインストルメンテーションによるオートディスカバリー、Fluentdのオプションをサポートしています。

スクリプトがサポートするすべての設定オプションを表示するには、-h フラグを使用します。

curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh;
sh /tmp/splunk-otel-collector.sh -h

Collector 🔗

オプション

説明

デフォルト値

--api-url <url>

指定されたレルムから推測されるエンドポイントを使用する代わりに、API エンドポイント URL を明示的に設定します。

https://api.REALM.signalfx.com

--collector-config <path>

--mode <agent|gateway> オプションに基づいて、Collectorパッケージが提供するデフォルトの構成ファイルを使用する代わりに、Collectorサービスの既存のカスタム構成ファイルへのパスを設定します。指定したファイルにカスタム環境変数が必要な場合は、インストール後に変数と値の両方を手動で /etc/otel/collector/splunk-otel-collector.conf に追加します。変更を有効にするには、sudo systemctl restart splunk-otel-collector コマンドを使用してCollectorserviceを再起動します。

agent モード用 /etc/otel/collector/agent_config.yamlgateway モード用 /etc/otel/collector/gateway_config.yaml

--collector-version <version>

インストールする Collector パッケージのバージョン。

latest

--discovery

Collector 起動時にディスカバリーモードを有効にします。詳細は App とサービスのオートディスカバリー を参照してください。

--hec-token <token>

指定された access_token と異なる場合は、HECトークンを設定します。

--hec-url <url>

指定されたレルムから推測されるエンドポイントを使う代わりに、明示的にHECエンドポイントURLを設定します。

https://ingest.REALM.signalfx.com/v1/log

--ingest-url <url>

指定されたレルムから推測されるエンドポイントを使用する代わりに、明示的にインジェスト・エンドポイントのURLを設定します。

https://ingest.REALM.signalfx.com

--memory <memory size>

Collector に割り当てる MIB メモリの合計。このオプションは、バラストサイズを自動的に計算します。Collectorのスケールとサイズを調整する方法の詳細は、サイジングとスケーリング を参照してください。

512

--mode <agent|gateway>

Collector サービスがホスト監視 ( agent ) またはデータ転送 ( gateway ) モードで実行されるように構成します。詳細は、Collector のデプロイモード を参照してください。

agent

--listen-interface <ip>

Collector レシーバーがリッスンするネットワーク・インターフェイス。

agent モード用 127.0.0.1、それ以外の場合は 0.0.0.0

--realm <us0|us1|eu0|...>

使用する Splunk レルム。インジェスト、API、トレース、HEC のエンドポイント URL は、この値を使用して自動的に生成されます。

us0

--service-group <group>

splunk-otel-collector サービスのグループを設定します。このオプションは、グループが存在しない場合に作成します。

splunk-otel-collector

--service-user <user>

splunk-otel-collector サービスのユーザーを設定します。このオプションは、ユーザーが存在しない場合に作成します。

splunk-otel-collector

--skip-collector-repo

デフォルトでは、https://splunk.jfrog.io からCollectorパッケージをダウンロードするためにapt、yum、またはzypper repo定義ファイルが作成されます。前のステップをスキップして、splunk-otel-collector debまたはrpmパッケージを提供するターゲットシステム上の設定されたrepoを使用するには、このオプションを使用します。

--trace-url <url>

指定されたレルムから推測されるエンドポイントではなく、明示的にトレースエンドポイント URL を設定します。

https://ingest.REALM.signalfx.com/v2/trace

--

アクセストークンが -- で始まる場合(例: - )は、-- -MY-ACCESS-TOKEN を使用します。

--uninstall

Linux 用 Splunk OpenTelemetry Collector を削除します。

バックエンドサービスのゼロコードインストルメンテーションによるオートディスカバリー 🔗

オプション

説明

デフォルト値

--with[out]-instrumentation

splunk-otel-auto-instrumentation パッケージをインストールし、libsplunk.so 共有オブジェクトライブラリを /etc/ld.so.preload に追加して、ホスト上のサポートされているすべてのプロセスのゼロコードインストルメンテーションを有効にするかどうか。--with-systemd-instrumentation オプションと組み合わせることはできません。詳細は Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション を参照してください。

--without-instrumentation

--with[out]-systemd-instrumentation

splunk-otel-auto-instrumentation パッケージをインストールし、systemdドロップインファイルを設定して、systemdサービスとして実行されているすべてのサポートアプリケーションのゼロコードインストルメンテーションを有効にするかどうか。--with-instrumentation オプションと組み合わせることはできません。詳しくは Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション を参照してください。

--without-systemd-instrumentation

--with[out]-instrumentation-sdk <sdk>

特定の言語のゼロコードインストルメンテーションを有効にするかどうか。このオプションは、サポートしている自動インストルメンテーション SDK をカンマ区切りで指定します。現在サポートされている値: javanodedotnet 。指定した言語のみを有効にするには、--with-instrumentation-sdk を使用します(例: --with-instrumentation-sdk java )。注:.NET( dotnet )のゼロコードインストルメンテーションは、x86_64/amd64 でのみサポートされています。

--with-instrumentation-sdk java,nodejs,dotnet

--npm-path <path>

Node.js のゼロコードインストルメンテーションが有効になっている場合、 Node.jsパッケージの Splunk OpenTelemetry ゼロコードインストルメンテーションをインストールするには npm が必要です。 npmcommand -v npm シェルコマンドで見つからない場合、またはインストールに失敗した場合、Node.js のゼロコードインストルメンテーションは有効になりません。このオプションを使用して、 npm へのカスタムパスを指定します (例: --npm-path /my/path/to/npm )。

npm

--deployment-environment <value>

deployment.environment リソース属性を指定した値に設定します。指定しない場合、Splunk APM UI の Environment は、すべてのインストルメント済みアプリケーションの unknown として表示されます。リソース属性は OTEL_RESOURCE_ATTRIBUTES 環境変数に追加されます。

--service-name <name>

インストルメント化されたすべてのアプリケーションに対して、自動生成されたサービス名を指定した値で上書きします。値が OTEL_SERVICE_NAME 環境変数に設定されます。

--otlp-endpoint <host:port>

すべてのアクティブ化されたSDKのキャプチャされたトレース、ログ、およびメトリックのOTLPエンドポイントを設定します。値は OTEL_EXPORTER_OTLP_ENDPOINT 環境変数に設定されます。指定しない場合、デフォルトの動作は、アクティブ化された各SDKのデフォルト値 OTEL_EXPORTER_OTLP_ENDPOINT に延期されます。

--otlp-endpoint-protocol <protocol>

OTLPエンドポイントのプロトコル、例えば、grpc または http/protobuf を設定します。値は OTEL_EXPORTER_OTLP_PROTOCOL 環境変数に設定されます。指定されない場合、デフォルトの動作は、各アクティブ化されたSDKのデフォルトの OTEL_EXPORTER_OTLP_PROTOCOL 値に延期されます。

--metrics-exporter <exporters>

すべての有効化されたSDKによって収集されたメトリクスのエクスポーターのコマ区切りリスト。例: otlp,prometheus。メトリクスの収集とエクスポートを無効にするには、この値を none に設定します。この値は、 OTEL_METRICS_EXPORTER 環境変数に設定されます。デフォルトの動作は、アクティブ化された各SDKのデフォルトの OTEL_METRICS_EXPORTER 値に従います。

--logs-exporter <exporter>

すべてのアクティブ化されたSDKによって収集されたログのエクスポーターを設定します(例: otlp )。ログの収集とエクスポートを非アクティブにするには、値を none に設定します。 OTEL_LOGS_EXPORTER 環境変数にはこの値が含まれています。デフォルトでは、アクティブ化された各SDKはデフォルトの OTEL_LOGS_EXPORTER 値を使用します。

--[enable|disable]-profiler

SPLUNK_PROFILER_ENABLED 環境変数をサポートする、すべてのアクティブにされたSDKのAlwaysOn CPU Profilingをアクティブまたは非アクティブにします。

--disable-profiler

--[enable|disable]-profiler-memory

SPLUNK_PROFILER_MEMORY_ENABLED 環境変数をサポートする、すべてのアクティブにされたSDKのAlwaysOn Memory Profilingをアクティブまたは非アクティブにします。

--disable-profiler-memory

--[enable|disable]-metrics

SPLUNK_METRICS_ENABLED 環境変数をサポートする、すべてのアクティブにされたSDKのメトリクス収集およびエクスポートをアクティブまたは非アクティブにします。

--disable-metrics

--instrumentation-version

インストールする splunk-otel-auto-instrumentation パッケージのバージョン。注:Java および Node.js ゼロコードインストルメンテーションの最小サポートバージョンは 0.87.0 で、.NET ゼロコードインストルメンテーションの最小サポートバージョンは 0.99.0 です。

latest

Fluentd 🔗

オプション

説明

デフォルト値

--with[out]-fluentd

ログイベントをCollector に転送するためにfluentdをインストールして設定するかどうか。詳細は FluentdによりLinuxログを収集する を参照してください。

--without-fluentd

--skip-fluentd-repo

デフォルトでは、https://packages.treasuredata.com からfluentd deb/rpmパッケージをダウンロードするためにapt/yum repo定義ファイルが作成されます。前のステップをスキップして、td-agent deb/ rpmパッケージを提供するターゲットシステム上の設定されたrepoを使用するには、このオプションを使用します。

次のステップ 🔗

パッケージをインストールしたら、以下を参照してください:

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