インストーラ・スクリプトを使用して 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
含まれるパッケージ 🔗
インストーラ・スクリプトは、これらの要素をデプロイし、設定します:
Splunk Distribution of the OpenTelemetry Collector for Linux
td-agentを使ったFluentd。デフォルトではオフになっています。詳しくは FluentdによりLinuxログを収集する と Fluent Forward レシーバー を参照してください。
JMXメトリクスギャザラー
インストーラ・スクリプトを使用してCollectorをインストールする 🔗
インストーラ・スクリプトを使用してCollectorパッケージをインストールするには、以下の手順に従ってください:
systemd
、curl
、sudo
がインストールされていることを確認します。このコマンドを使用して、インストーラ・スクリプトをダウンロードして実行します。
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/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
バックエンドアプリケーションの自動ディスカバリーを設定する 🔗
また、Collectorのインストールと一緒に、Java、Node.js、.NETアプリケーションを自動的にインストルメンテーションすることもできます。自動ディスカバリーにより、各バックエンドアプリケーションにレシーバーを設定する必要がなくなります。インストール手順については Linux でのバックエンドアプリケーションのゼロコードインストルメンテーション を参照してください。
APM インストルメンテーションの詳細については、次を参照してください:
DockerのあるCollector for Linux 🔗
Dockerを使用してホストでCollectorをインストールする 🔗
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 <...>
コンテナで自動ディスカバリーを使用する 🔗
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 を明示的に設定します。 |
|
|
|
|
|
インストールする Collector パッケージのバージョン。 |
|
|
Collector 起動時にディスカバリーモードを有効にします。詳細は App とサービスのオートディスカバリー を参照してください。 |
|
|
指定された |
|
|
指定されたレルムから推測されるエンドポイントを使う代わりに、明示的にHECエンドポイントURLを設定します。 |
|
|
指定されたレルムから推測されるエンドポイントを使用する代わりに、明示的にインジェスト・エンドポイントのURLを設定します。 |
|
|
Collector に割り当てる MIB メモリの合計。このオプションは、バラストサイズを自動的に計算します。Collectorのスケールとサイズを調整する方法の詳細は、サイジングとスケーリング を参照してください。 |
|
|
Collector サービスがホスト監視 ( |
|
|
Collector レシーバーがリッスンするネットワーク・インターフェイス。 |
|
|
使用する Splunk レルム。インジェスト、API、トレース、HEC のエンドポイント URL は、この値を使用して自動的に生成されます。 |
|
|
splunk-otel-collector サービスのグループを設定します。このオプションは、グループが存在しない場合に作成します。 |
|
|
splunk-otel-collector サービスのユーザーを設定します。このオプションは、ユーザーが存在しない場合に作成します。 |
|
|
デフォルトでは、 |
|
|
指定されたレルムから推測されるエンドポイントではなく、明示的にトレースエンドポイント URL を設定します。 |
|
|
アクセストークンが |
|
|
Linux 用 Splunk OpenTelemetry Collector を削除します。 |
バックエンドサービスのゼロコードインストルメンテーションによるオートディスカバリー 🔗
オプション |
説明 |
デフォルト値 |
---|---|---|
|
|
|
|
|
|
|
特定の言語のゼロコードインストルメンテーションを有効にするかどうか。このオプションは、サポートしている自動インストルメンテーション SDK をカンマ区切りで指定します。現在サポートされている値: |
|
|
Node.js のゼロコードインストルメンテーションが有効になっている場合、 Node.jsパッケージの Splunk OpenTelemetry ゼロコードインストルメンテーションをインストールするには |
|
|
|
|
|
インストルメント化されたすべてのアプリケーションに対して、自動生成されたサービス名を指定した値で上書きします。値が |
|
|
すべてのアクティブ化されたSDKのキャプチャされたトレース、ログ、およびメトリックのOTLPエンドポイントを設定します。値は |
|
|
OTLPエンドポイントのプロトコル、例えば、 |
|
|
すべての有効化されたSDKによって収集されたメトリクスのエクスポーターのコマ区切りリスト。例: |
|
|
すべてのアクティブ化されたSDKによって収集されたログのエクスポーターを設定します(例: |
|
|
|
|
|
|
|
|
|
|
|
インストールする |
|
Fluentd 🔗
オプション |
説明 |
デフォルト値 |
---|---|---|
|
ログイベントをCollector に転送するためにfluentdをインストールして設定するかどうか。詳細は FluentdによりLinuxログを収集する を参照してください。 |
|
|
デフォルトでは、 |
次のステップ 🔗
パッケージをインストールしたら、以下を参照してください: