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

OpenTelemetry Collector for Linux の Splunk ディストリビューションは、すべてのデータタイプに対して統合された収集と転送を提供するパッケージです。

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

インストーラ・スクリプトを使用する
デプロイメントおよびコンフィギュレーション管理ツールを使用する
Collector for Linuxを手動でインストールする

インストーラ・スクリプト 🔗

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

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

Splunk Distribution of OpenTelemetry Collector for Linux
td-agentを使ったFluentd。デフォルトではオフになっています。詳しくは Fluent Forward レシーバーを参照してください。

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

Ensure you have systemd, curl and sudo installed.
インストーラ・スクリプトをダウンロードして実行します。
以下の変数を環境に合わせて置き換えてください：

SPLUNK_REALM:これはデータを送信するレルムです。デフォルトは us0 です。Splunk レルムを見つけるには、レルムについての注意を参照してください。
SPLUNK_MEMORY_TOTAL_MIB:メビバイト（MiB）単位で割り当てられたメモリの合計。例えば、512 は512MiB (500 x 2^20バイト)のメモリを割り当てます。
SPLUNK_ACCESS_TOKEN:データ取り込みリクエストを認証するための、base64 エンコードされたアクセストークンです。Splunk Observability Cloudを使用した組織のアクセストークンの作成および管理を参照してください。

The command to download and invoke the installer script is as follows:

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

注釈

Log Observer 権限を持っているか、Fluentd でターゲットホストのログを収集したい場合は、Collector をインストールするときに、--with-fluentd オプションを使用して Fluentd もインストールします。

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

メモリ割り当てを設定するには、--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

Fluentdを設定する 🔗

Fluentd はデフォルトではオフになっています。ログ収集のために Fluentd をインストールするには、--with-fluentd オプションをつけてインストーラー・スクリプトを実行します。例：

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

オンにすると、Fluentd サービスはデフォルトで、@SPLUNK ラベルのログイベントを収集し、Collector に転送するように設定され、Collector は --realm <SPLUNK_REALM> オプションで決定された HEC インジェスト・エンドポイントにこれらのイベントを送ります。例えば、https://ingest.<SPLUNK_REALM>.signalfx.com/v1/log。

以下のFluentdプラグインもインストールされています：

Linuxの機能を有効にする capng_c。
systemd ジャーナル・ログ収集用 fluent-plugin-systemd。

さらに、Fluentd プラグインの前提条件として、以下の依存関係がインストールされます：

Debianベースのシステム：

build-essential
libcap-ng0
libcap-ng-dev
pkg-config

RPMベースのシステム：

開発ツール
libcap-ng
libcap-ng-devel
pkgconfig

以下のパラメータを指定して、カスタム Splunk HTTP Event Collector (HEC) エンドポイント URL にログイベントを送信するようにパッケージを設定できます：

--hec-url <URL>
--hec-token <TOKEN>

HEC を使用すると、HTTP および Secure HTTP (HTTPS) プロトコルを介して Splunk デプロイメントにデータとアプリケーションイベントを送信できます。HTTP Event Collector をセットアップして使用するを参照してください。

主な Fluentd の設定は /etc/otel/collector/fluentd/fluent.conf にインストールされます。カスタム Fluentd ソース設定ファイルは、インストール後に /etc/otel/collector/fluentd/conf.d ディレクトリに追加できます。

次のことに注意してください：

このディレクトリでは、.conf という拡張子を持つすべてのファイルが、Fluentd によって自動的に包含されます。
td-agentユーザーは、コンフィギュレーションファイルとその中に定義されたパスにアクセスする権限を持っていなければなりません。
デフォルトでは、Fluentd は systemd ジャーナルログイベントを /var/log/journal から収集するように設定されています。

設定を変更したら、sudo systemctl restart td-agent を実行して td-agent サービスを再起動します。

初回インストール後にtd-agentパッケージがアップグレードされた場合、td-agentバージョン4.1以降では、以下の手順で新しいバージョンのLinux機能を設定する必要がある可能性があります。：

アクティブにされた機能をチェックします：

sudo /opt/td-agent/bin/fluent-cap-ctl --get -f /opt/td-agent/bin/ruby
Capabilities in `` /opt/td-agent/bin/ruby`` ,
Effective:   dac_override, dac_read_search
Inheritable: dac_override, dac_read_search
Permitted:   dac_override, dac_read_search

先のコマンドの出力に、上記のように dac_override と dac_read_search が含まれていない場合は、以下のコマンドを実行します：

sudo td-agent-gem install capng_c
sudo /opt/td-agent/bin/fluent-cap-ctl --add "dac_override,dac_read_search" -f /opt/td-agent/bin/ruby
sudo systemctl daemon-reload
sudo systemctl restart td-agent

すでにホストに Fluentd をインストールしている場合は、--without-fluentd オプションを使用して、Fluentd なしで Collector をインストールしてください。詳細ははじめに：Collectorを理解して使用するを参照してください。

Configure automatic discovery for Java 🔗

You can also automatically instrument your Java applications along with the Collector installation. Automatic discovery removes the need to install and configure the Java agent separately. See Automatic discovery and configuration for back-end applications in Linux for the installation instructions. For more information on Java instrumentation, see Splunk Observability Cloud 用 Java アプリケーションのインストルメンテーション.

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

Linuxインストーラー・スクリプトは、以下のオプションをサポートしています：

オプション	説明	デフォルト値
`--api-url <url>`	指定されたレルムから推測されるエンドポイントを使用する代わりに、API エンドポイント URL を明示的に設定します。	`https://api.REALM.signalfx.com`
`--ballast <ballast size>`	`--memory` オプションを使用して計算された値ではなく、明示的にバラストサイズを設定します。詳細はサイジングとスケーリングを参照してください。	`512`
`--beta`	ベータ版パッケージ・リポジトリを使用してください。	該当なし
`--collector-config <path>`	`--mode <agent\|gateway>` オプションに基づいて、Collector パッケージが提供するデフォルトの構成ファイルを使用する代わりに、Collector サービスの既存のカスタム構成ファイルへのパスを設定します。指定したファイルにカスタム環境変数が必要な場合は、インストール後に変数と値の両方を手動で `$collector_env_path` に追加します。変更を有効にするには、`sudo systemctl restart splunk-otel-collector` コマンドを使用して Collectorservice を再起動します。
`--collector-version <version>`	インストールする Collector パッケージのバージョン。	`latest`
`--discovery`	Collector 起動時にディスカバリーモードを有効にします。詳細は Discover telemetry sources automatically を参照してください。	非アクティブ
`--hec-token <token>`	`` s different than the specified `` 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 メモリの合計。このオプションは、バラストサイズを自動的に計算します。詳細は、サイジングとスケーリングを参照してください。	`512`
`--mode <agent\|gateway>`	Collector サービスがホスト監視 ( `agent` ) またはデータ転送 ( `gateway` ) モードで実行されるように構成します。詳細は、Collector のデプロイモードを参照してください。	`agent`
`--listen-interface <ip>`	Collector レシーバーがリッスンするネットワークインターフェイス。	`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`	デフォルトでは、スクリプトは `$repo_base` から Collector パッケージをダウンロードするために apt、yum、または zypper repo 定義ファイルを作成します。前のステップをスキップして、splunk-otel-collector deb または rpm パッケージを提供するターゲットシステム上の設定された repo を使用するには、このオプションを使用します。
`--skip-fluentd-repo`	デフォルトでは、スクリプトは、`$td_agent_repo_base` から fluentd パッケージをダウンロードするために、apt、yum、または zypper のレポ定義ファイルを作成します。前のステップをスキップして、splunk-otel-collector deb または rpm パッケージを提供するターゲットシステム上の設定されたレポを使用するには、このオプションを使用します。
`--test`	テストパッケージレポを使用します。	該当なし
`--trace-url <url>`	指定されたレルムから推測されるエンドポイントではなく、明示的にトレースエンドポイント URL を設定します。	`https://ingest.REALM.signalfx.com/v2/trace`
`--uninstall`	Linux 用 Splunk OpenTelemetry Collector を削除します。	該当なし
`--with[out]-fluentd`	ログイベントをCollector に転送するためにfluentdをインストールして設定するかどうか。詳細は Fluentdを設定するを参照してください。	`--without-fluentd`
`--with[out]-instrumentation`	Whether to install and configure the splunk-otel-auto-instrumentation package. See Automatic discovery and configuration for back-end applications in Linux for more information.	`--without-instrumentation`
`--deployment-environment <value>`	`deployment.environment` リソース属性を指定された値に設定します。`--with-instrumentation` オプションも指定されている場合のみ適用可能。	空
`--service-name <name>`	このホスト上のすべてのインストルメンテーションされた Javaアプリケーションの自動生成サービス名を `<name>` で上書きします。`--with-instrumentation` オプションも指定されている場合にのみ適用されます。	空
`--[enable\|disable]-profiler`	AlwaysOn CPU プロファイリングを有効または無効にします。`--with-instrumentation` オプションも指定されている場合にのみ適用できます。	`--disable-profiler`
`--[enable\|disable]-profiler-memory`	AlwaysOn Memory Profiling を有効または無効にします。`--with-instrumentation` オプションも指定されている場合にのみ適用できます。	`--disable-profiler-memory`
`--[enable\|disable]-metrics`	Activate or deactivate exporting metrics. Only applicable if the `--with-instrumentation` option is also specified.	`--disable-metrics`
`--instrumentation-version`	インストールするパッケージのバージョン。`--with-instrumentation` オプションも指定した場合にのみ適用されます。	`latest`
`--`	アクセストークンが `-` で始まる場合は `--` を使用します。	該当なし

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

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

デプロイツールを使用して Collector をインストールする 🔗

Splunk はこのセクションで説明する設定管理オプションを提供します。

Amazon ECS EC2 🔗

注釈

Prometheusのみで使用可能。

Splunk は、Splunk Distribution of OpenTelemetry Collector を ECS EC2 にデプロイするためのタスク定義を提供します。タスク定義は JSON 形式のテキストファイルで、アプリケーションを構成する 1つ以上のコンテナを記述します。インストール手順については Amazon ECS EC2 でCollectorをデプロイするを参照してください。

Amazon Fargate 🔗

注釈

Prometheusのみで利用可能。Amazon EKSでは未対応。

Splunk は、Amazon ECS タスクのサイドカー (追加コンテナ) として Amazon Fargate に OpenTelemetry Collector の Splunk Distribution をデプロイするためのガイド付きセットアップを提供しています。インストール手順については Amazon ECS Fargate でCollectorをデプロイするを参照してください。

Ansible 🔗

Splunk は、Linux マシンからデータ (メトリクス、トレース、ログ) を収集し、そのデータを Splunk Observability Cloud に送信するように設定されたパッケージをインストールする Ansible ロールを提供します。ロールをダウンロードしてカスタマイズする手順については、Ansible for LinuxでCollectorをデプロイするを参照してください。

Chef 🔗

Splunk は Chef を使って Collector をインストールするための Cookbook を提供しています。インストール手順については ChefでCollectorをデプロイするを参照してください。

Heroku 🔗

Splunk Distribution of OpenTelemetry Collector for Heroku は Collector 用の buildpack です。この buildpack は、Dyno 上に Collector をインストールして実行し、Splunk Observability Cloud 用のメトリクスデータとトレースデータを受信、処理、エクスポートします。buildpack のインストール手順については Heroku を参照してください。

Nomad 🔗

Nomad を使用して Collector をデプロイします。インストール手順は Nomad でCollectorをデプロイするを参照してください。

Pivotal Cloud Foundry 🔗

Pivotal Cloud Foundry（PCF）でCollectorをデプロイするには、これら3つのオプションのいずれかを使用できます：

Collector のスタンドアロン・デプロイ。
アプリのサイドカーとしての Collector。
Tanzu Tile。

詳細は、Pivotal Cloud FoundryでCollectorをデプロイするを参照してください。

Puppet 🔗

Splunk は、パッケージのインストールと設定を行うための Puppet モジュールを提供します。モジュールとは、リソース、クラス、ファイル、定義、テンプレートの集まりです。モジュールをダウンロードしてカスタマイズする手順については、Puppet for Linux でCollectorをデプロイするを参照してください。

Salt 🔗

Splunk は、Collector をインストールして設定するための Salt 式を提供しています。手順については SaltでCollectorをデプロイするを参照してください。

次のステップ 🔗

After you’ve installed the package, you can perform these actions:

Collector の構成。
Infrastructure Monitoring を使用して、インフラの健全性を追跡します。
アプリケーションのパフォーマンスを監視するには、APM を使用します。
Log Observer Connect を使用して、ログイベントを分析し、サービスの問題をトラブルシューティングします。

This page was last updated on 2024年06月25日.

Related Topics

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