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

OpenTelemetry Collector の Splunk ディストリビューションのプラットフォーム固有のインストール情報について説明します。Splunk Distribution of OpenTelemetry Collector の設定方法についても説明します。デフォルトの構成ファイルだけでなく、設定可能な追加コンポーネントもあります。

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

Splunk Distribution of the OpenTelemetry Collector をインストール、デプロイ、設定するために使用できるオプションから開始します。次に、Collector の使用方法について説明します。

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

パッケージとデプロイメントツールを使用して Collector をインストールする

Splunk Distribution of the OpenTelemetry Collector は、Kubernetes、Linux、Windows でサポートされています。次のいずれかのパッケージを使用して、Splunk Observability Cloud のデータを収集します。

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

Collector の Docker イメージの検証

Collector の Docker イメージは自動署名されます。ソフトウェアパッケージの検証と信頼が必要な場合は、以下の公開キーを使用して、バージョン 0.93 以降の Collector の Docker イメージを検証してください。

-----BEGINPUBLICKEY-----MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAnQi0COAQC5XgALFAyTW3JXiHvXJLIFKK+LKS8iVo0Ec2tsABJ5usp5yCYTENJHoS1fLC5XcY5nyM4fqxjWJK3FqDa/inWkryNgpW8Mx5LhjGiIxiBiMnONFh0cZNctbQ7mNTBZgisiwThDTOovtW660MCCeZdPAMdSHaDym7GWAQi1tVWMioI2r9s5DUbwbzK5z9z/HZuX9Su2KJxxG6TagdZB6EyhkdyV/LR1ud5R/5P2ouRt/DpIj/iSRnkTV28wDRSf//QR75SiyDW2zoph5MmkD88H5aTw22cJ35sFo3S+NLxakrQZzyH1G4oY6vpQ8h0hMYJ9zAJZxA/kzNmLZ/V4QVj8tkJaj7igcOKpfatQUu7n6HapCLhoNAcrnDskf23V4PxUJ+MIAN2vwPSUMTI2rKrEPpilAKup4l7EsxX2Dm73umh/xyWaKlpw8kAsB9dLuSj3gnh/k3SX6qwWkQASkbjBRe+iPrkVcRNfOvIHp/bg8kd5q4JwEIDh4x/JEf/l6zLpEar8hh2dSWVbbHBd5Xo9Ge5BjwXOcoDhvUQqNJdLBJruhvhn7Ogy5Paw5TGhdawfjxT2yXeqbEJuv6qdo/mSimkpR8lkQT7OsfAQbCPeyFvZKb22hXj6tCTVJncwCJLe/FBdXJhRepY6NEdmKZLGodXv4zLNVr7SkCAwEAAQ==
-----ENDPUBLICKEY-----

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

-----BEGINPUBLICKEY-----MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAw+sL4Mx2Ip9AxTSp7Iw2k69tlJ8RqYNngJyecOLLiQkubgIQdnAkQurTfCPCuCHChvGGw3WCV617oJR25D0hNzOvS9wIXc1mEdsHCFbOuAVnJ7GLALmci6sR09jPiQnl2X58+edI/2g6j77G1Lz3B/aOK4p70Ro2TTE6Xj6XACeLkAZGu1W3UQfrJiYkGz4PovWMyeF2J88RcwrrdOLni5iFeLR5EL8TtoQCXUyqJFpuXpBkLbMedrpZAODqBcg3iwfeACcguO2X1cCWFXM+ubN1fzf2c+WrO3sg8io1cHTctX2GG+9r7DbqRuo0Ejj2D0fTi/JoVBCTXNxn2DrgL86Y5+mtpUN+MlnzZRFEbCqN2fC9CO1LlriD+3NKAuW7OVM10S/+eHApUQi1Ao5AABfjRxHWn2SISC5pmgYDeg90Lf0BTjX2+qn1HuJXDZUyD1XEeXedqE+/m9mgEU2suYOqk6ecD/qowv2gvkwd742XvfpZhaMCdehtVJwB5HLAv4VtQQYLECgMrqipAALybAExcAb0i16mMJi2QCPh44BrzcLQW/SZxYr9sg3IQXWBE84XbuzSyHJwBjvyxgf52+TlQ3bUY73ssOe/WV3FAdDHh0ekQdOKO4plPPMXmdYCH2dY5ji5bunY+kKHayT7pqX7nYPWHh4c2RvHkE3Tth8CAwEAAQ==
-----ENDPUBLICKEY-----

イメージは cosign を使用して署名されます。これを確認するには、以下を実行します。

公開キーをファイルに保存します。たとえば、cosign.pub のようになります。

以下のコマンドを実行します：

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

注: OpenTelemetry Operator DockerイメージはLinuxのみをサポートしており、Windowsノード上では実行できません。

コレクタの設定：構成ファイル、自動検出、およびその他の設定ソース

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

___ ______ ____________ __ ___ _____________ _________ ___ ___ _________ _____________ _______ ____ ___ __ ____ __ _______ _________ ___________

自動ディスカバリー

Splunk Observability Cloud では、手間のかからない自動検出と設定のための複数のオプションをご用意しています。詳細については、「アプリケーションとサービスの自動検出」を参照してください。

複数の構成ファイルを使用する

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

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

追加設定ソース

これらの追加設定ソースを使用することもできます。

ログの収集

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

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

Collector を使用する

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

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

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

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

Collector のコンポーネントとサービス

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

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

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

Collector 変数と内部メトリクス

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