インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。 🔗
The Splunk Distribution of the OpenTelemetry Collector for Linux is a package that provides integrated collection and forwarding for all data types.
以下のいずれかの方法でパッケージをインストールします：
Use the installer script, as described in this document
対応バージョン 🔗
Collector は以下のLinuxディストリビューションとバージョンをサポートしています：
Amazon Linux: 2, 2023.Fluentdによるログ収集は、現在Amazon Linux 2023ではサポートされていません。
CentOS、Red Hat、またはOracle: 7、8、9
Debian: 9, 10, 11
SUSE: 12, 15 バージョン 0.34.0 以上。Fluentd によるログ収集は現在サポートされていません。
Ubuntu: 16.04, 18.04, 20.04, 22.04, and 24.04
Rocky Linux: 8, 9
含まれるパッケージ 🔗
インストーラ・スクリプトは、これらの要素をデプロイし、設定します：
The Splunk Distribution of the OpenTelemetry Collector for Linux
Fluentd, using the td-agent. Turned off by default. See Collect Linux logs with Fluentd and Fluent Forward レシーバー for more information
JMX metric gatherer
Install the Collector using the installer script 🔗
To install the Collector package using the installer script, follow these steps:
Ensure you have
systemd,curlandsudoinstalled.Download and run the installer script using this command:
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_TOKENReplacing the following variables for your environment:
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/splunk と https://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
Configure automatic discovery for back-end applications 🔗
You can also automatically instrument your Java, Node.js, and .NET applications along with the Collector installation. Automatic discovery removes the need to configure receivers for each back-end application. See Zero-code instrumentation for back-end applications in Linux for the installation instructions.
For more information on APM instrumentation, see:
Collector for Linux with Docker 🔗
Install the Collector in a host with Docker 🔗
Dockerを使用してCollectorインスタンスをホストにインストールしている場合は、デーモンとの接続を確立するためにクライアントを設定する必要があります。DockerのインストールとCollectorのデプロイ方法に応じて、以下のオプションのいずれかを試してください：
デーモンがドメインソケット（たとえば
/var/run/docker.sock）をリッスンしている場合、Collectorサービスまたは実行ファイルに適切な権限とアクセスが必要です。システムで設定されているDockerグループにsplunk-otel-collectorユーザーを追加します：
$ usermod -aG docker splunk-otel-collector
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 <...>
Use auto discovery with containers 🔗
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
Options of the installer script of the Collector for Linux 🔗
The Linux installer script supports the following options for the Collector, automatic discovery with zero-code instrumentation for back-end services, and 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 を明示的に設定します。 |
|
|
Set the path to an existing custom configuration file for the Collector service instead of using the default configuration file provided by the Collector package based on the |
|
|
インストールする Collector パッケージのバージョン。 |
|
|
Collector 起動時にディスカバリーモードを有効にします。詳細は Automatic discovery of apps and services を参照してください。 |
|
|
Set the HEC token if it is different than the specified |
|
|
指定されたレルムから推測されるエンドポイントを使う代わりに、明示的にHECエンドポイントURLを設定します。 |
|
|
指定されたレルムから推測されるエンドポイントを使用する代わりに、明示的にインジェスト・エンドポイントのURLを設定します。 |
|
|
Total memory in MIB to allocate to the Collector. This option automatically calculates the ballast size. See サイジングとスケーリング for more information on how to scale and size the Collector. |
|
|
Collector サービスがホスト監視 ( |
|
|
Collector レシーバーがリッスンするネットワーク・インターフェイス。 |
|
|
使用する Splunk レルム。インジェスト、API、トレース、HEC のエンドポイント URL は、この値を使用して自動的に生成されます。 |
|
|
splunk-otel-collector サービスのグループを設定します。このオプションは、グループが存在しない場合に作成します。 |
|
|
splunk-otel-collector サービスのユーザーを設定します。このオプションは、ユーザーが存在しない場合に作成します。 |
|
|
By default, a apt, yum, or zypper repo definition file is created to download the Collector package from |
|
|
指定されたレルムから推測されるエンドポイントではなく、明示的にトレースエンドポイント URL を設定します。 |
|
|
Use |
|
|
Linux 用 Splunk OpenTelemetry Collector を削除します。 |
Automatic discovery with zero-code instrumentation for back-end services 🔗
オプション |
説明 |
デフォルト値 |
|---|---|---|
|
Whether to install the |
|
|
Whether to install the |
|
|
Whether to enable zero-code instrumentation for a specific language. This option takes a comma separated set of values representing supported auto-instrumentation SDKs. Currently supported values: |
|
|
If zero-code instrumentation for Node.js is enabled, |
|
|
|
|
|
Override the auto-generated service names for all instrumented applications with the specified value. The value will be set to the |
|
|
すべてのアクティブ化されたSDKのキャプチャされたトレース、ログ、およびメトリックのOTLPエンドポイントを設定します。値は |
|
|
OTLPエンドポイントのプロトコル、例えば、 |
|
|
すべての有効化されたSDKによって収集されたメトリクスのエクスポーターのコマ区切りリスト。例： |
|
|
すべてのアクティブ化されたSDKによって収集されたログのエクスポーターを設定します（例： |
|
|
Activate or deactivate AlwaysOn CPU Profiling for all activated SDKs that support the |
|
|
Activate or deactivate AlwaysOn Memory Profiling for all activated SDKs that support the |
|
|
Activate or deactivate collection and exporting metrics for all activated SDKs that support the |
|
|
The |
|
Fluentd 🔗
オプション |
説明 |
デフォルト値 |
|---|---|---|
|
ログイベントをCollector に転送するためにfluentdをインストールして設定するかどうか。詳細は Collect Linux logs with Fluentd を参照してください。 |
|
|
By default, a apt/yum repo definition file will be created to download the fluentd deb/rpm package from |
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください：