はじめに：Collectorを理解して使用する 🔗

Collectorの概要については、Splunk Distribution of the OpenTelemetry Collector の利用開始を参照してください。

Splunk Distribution of the OpenTelemetry Collector をインストール、デプロイ、設定するために利用可能なオプションから始めましょう。次に、Collector の使用方法を学びます。

互換性のあるCPUアーキテクチャーとオペレーティングシステムについては、プロセッサー・アーキテクチャーを参照してください。
Collectorの 2 つのデプロイメントモードについては、Collector のデプロイモードを参照してください：ホスト監視（エージェント）モード、およびデータ転送（ゲートウェイ）モード。

Install the Collector using packages and deployment tools¶

The Splunk Distribution of the OpenTelemetry Collector is supported on Kubernetes, Linux, and Windows. Use one of the following packages to gather data for Splunk Observability Cloud:

その他のデプロイツールとオプションも参照してください。

Verify the Docker image of the Collector¶

CollectorのDockerイメージは自動的に署名されます。

ソフトウェアパッケージを検証して信頼する必要がある場合は、以下の公開鍵を使用して、バージョン 0.93 以上の Collectorの Docker イメージを検証してください：

古いバージョンの Collector では、この公開鍵を使用します：

画像は cosign を使って署名されています。検証するには：

公開鍵をファイルに保存します。例えば、cosign.pub。
以下のコマンドを実行します：

cosign verify --insecure-ignore-tlog --key cosign.pub quay.io/signalfx/splunk-otel-collector:<collector-version>

注釈

The OpenTelemetry Operator Docker image only supports Linux and cannot run on Windows nodes.

Configure the Collector: Config files, auto discovery, and other configuration sources¶

これらの設定を使用して、各 Collector パッケージのデフォルト設定を変更します：

Splunk Distribution of the OpenTelemetry Collectorには、いくつかの :ref:` で使用できる以下の <collector-common-config>` 設定オプション Collector コンポーネントがあります。

Automatic discovery¶

Splunk Observability Cloudは、手間のかからない自動ディスカバリーと設定のためのオプションをいくつか提供しています。詳しくは App とサービスのオートディスカバリーをご覧ください。

Use multiple configuration files¶

複数の設定ファイルを同時に定義するには、次を使用します：

./otelcol --config=file:/path/to/first/file --config=file:/path/to/second/file

Additional configuration sources¶

また、これらの追加構成ソースを使用することもできます：

Collect logs ¶

Splunk Distribution of the OpenTelemetry Collectorでログを収集するには：

Kubernetes環境では、ネイティブのOpenTelemetryログ収集がデフォルトでサポートされています。詳しくは Collector for Kubernetes のログとイベントを収集するを参照してください。
Linux と Windows 環境 (物理ホストと仮想マシン) では、Universal Forwarder を使用してログを Splunk プラットフォームに送信します。詳しくは Collector で Splunk Universal Forwarder を使用するを参照してください。

注釈

ターゲットホストのログを収集したい場合は、CollectorインスタンスにFluentdをインストールして、有効にします。

Collect logs using Fluentd ¶

CollectorはFluentdを使用してログをキャプチャできますが、このオプションはデフォルトでは無効になっています。詳細は、Fluent Forward レシーバーを参照してください。

Fluentdを有効化するには、以下を参照してください：

filelog、journald、Windows Event Viewerのような一般的なソースは、インストールに含まれています。

Use the Collector¶

OpenTelemetryCollectorは、テレメトリデータを受信、処理、エクスポートするための技術にとらわれない方法です。

プラットフォームにCollectorをインストールしたら、設定ファイルを更新して、使用するCollectorコンポーネント（レシーバー、プロセッサー、エクスポーター）を定義します。ただし、レシーバーとエクスポーターは、次の段落で説明するように、パイプラインに入るまで有効になりません。診断やヘルスチェックなど、OpenTelemetry Collector に追加機能を提供する拡張機能を追加することもできます。使用可能なコンポーネントは、Collector コンポーネントを参照してください。

次に、データの処理方法を決定するために、サービスパイプラインを設定する必要があります。パイプラインセクションでは、レシーバー、プロセッサー、エクスポーターを結びつけ、データが通る経路を設計します。パイプラインは複数定義でき、1つのレシーバーまたはエクスポーター定義を複数のパイプラインで使用できます。また、1つのパイプラインに複数のレシーバーやエクスポーターを含めることもできます。詳しくはパイプラインでデータを処理するを参照してください。

Collectorの仕組みや使用方法については、以下のドキュメントも参照してください：

Components and services of the Collector¶

Splunk Distribution of the OpenTelemetry Collectorには、以下のコンポーネントとサービスがあります：

レシーバー: Collector にデータを取り込む方法を決定します。
プロセッサー：エクスポートする前にデータに対してどのような処理を行うかを設定します。例えば、フィルターリングなど。
エクスポーター: データの送信先を設定します。1つまたは複数のバックエンドまたは送信先を指定できます。
拡張： Collector の機能を拡張します。
コネクター：2つのパイプラインを接続し、一方のパイプラインの終了時にエクスポーターとしてデータを消費し、もう一方のパイプラインの開始時にレシーバーとしてデータを送信します。
サービス。これは2つの要素で構成されています：
- 設定した拡張機能のリスト。
- パイプライン: データが受信から加工や修正を経て、最終的にエクスポーターを経由して出るまでのパス。

詳細は Collector コンポーネントを参照してください。

Collector variables and internal metrics¶

Collectorは、これらの環境変数と内部メトリクスを使用して動作します：

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

Related Topics