Collector コンポーネント

Splunk Observability Cloud OpenTelemetry Collector を構成するコンポーネントについて学びます。

OpenTelemetry Collector には、以下のコンポーネントタイプがあります：

レシーバー：複数のソースから Collector にデータを取得します。
プロセッサ：エクスポートされる前にデータに対して処理を行います。たとえば、フィルタリングです。
エクスポータ：1 つまたは複数のバックエンドまたは宛先にデータを送信します。
拡張： Collector の機能を拡張します。
コネクタ：異なるコレクタパイプライン間でテレメトリデータを送信します。

Collector の設定でサービスパイプラインを設定することで、コンポーネントを有効化できます。コンポーネントの複数のインスタンスとそのパイプラインを定義する方法については「Get started: Understand and use the Collector」を参照してください。

Splunk Distribution of the OpenTelemetry Collectorには、このドキュメントに記載されているコンポーネントが含まれ、サポートされています。

注: 以下のリストには最新の追加がすべて含まれていない可能性があります。Splunk Distribution of OpenTelemetry Collector に含まれていないコンポーネントを含む Collector コンポーネントの完全なリストについては、GitHub の opentelemetry-contrib リポジトリを参照してください。

レシーバー


Name	説明	パイプラインの種類
Active Directory Domain Services レシーバ（`active_directory_ds`）	Windows Performance Counters を使用して、Active Directory ドメインコントローラに関連するメトリクスを取得します。	メトリクス
Apache Web Server レシーバー（`apache`）	Apache Webサーバーから統計を取得します。	メトリクス
Apache Spark レシーバー（`apachespark`）	Apache Spark REST APIを通じてApache Sparkクラスターのメトリクスを取得します。	メトリクス
AWS ECS コンテナメトリクスレシーバー（`awsecscontainermetrics`）	Amazon ECSからタスクメタデータとdocker統計を読み込み、リソース使用量のメトリクスを生成します。	メトリクス
Azure イベントハブレシーバー（`azureeventhub`）	Azure イベントハブからログをプルします。	ログ
Carbon レシーバー（`carbon`）	Carbon プレーンテキストプロトコルでメトリクスを受信します。	メトリクス
Chrony レシーバー（`chrony`）	システムやプラットフォーム間の移植性を追跡する `chronyc` コマンドのGo実装。	メトリクス
Cloud Foundry レシーバー（`cloudfoundry`）	Cloud FoundryのRLP（Reverse Log Proxy）ゲートウェイに接続し、メトリクスを抽出します。	メトリクス
CollectD レシーバー（`collectd`）	CollectD `write_http` プラグインからエクスポートされたデータを受信します。JSON 形式のみをサポートしています。	メトリクス
Discovery レシーバー（`discovery`）elasticsearch-receiver	メトリクス収集ターゲットの発見を容易にするために、レシーバークリエータをラップします。「App とサービスのオートディスカバリー」を参照してください。	ログ
Elasticsearch レシーバー（`elasticsearch`）	Elasticsearchノード時計、クラスター健全性、インデックス統計エンドポイントに問い合わせて、稼働中のElasticsearchクラスターからメトリクスをスクレイピングします。	メトリクス
Filelog レシーバー（`filelog`）	ファイルからのログを追尾し、解析します。	ログ
Fluent Forward レシーバー（`fluentforward`）	Fluentd Forward プロトコルでイベントを受け取る TCP サーバーを実行します。	ログ
HAProxy レシーバー（`haproxy`）	専用ソケットまたはHTTP URLを介してHAProxyプロセスを定期的にポーリングすることで、メトリクスを生成します。	メトリクス
ホストメトリクスレシーバー（`hostmetrics`）	さまざまなソースからシステムメトリクスを生成します。Collector をエージェントとして展開する場合は、このレシーバーを使用します。	メトリクス
HTTP チェックレシーバー（`httpcheck`）	HTTPエンドポイントに対して合成チェックを実行します。	メトリクス
IIS レシーバー（`iis`）	Windows Performance Counters を使用して、IIS インスタンスに関するメトリクスを取得します。	メトリクス
JMX レシーバー（`jmx`）	MBean サーバーからメトリクスをレポートするために、OpenTelemetry JMX Metric Gatherer と連携して動作します。	メトリクス
Journald レシーバー（`journald`）	systemd journal から Journald イベントを解析します。 `journalctl` バイナリは、エージェントと同じ `$PATH` 内にある必要があります。	ログ
Kafka レシーバー（`kafka`）	Kafka からメトリクス、ログ、トレースを受信します。メトリクスとログは OTLP 形式のみをサポートします。	メトリクス、ログ、トレース
Kafka メトリクスレシーバー（`kafkametrics`）	Kafkaサーバーからブローカー、トピック、パーティション、コンシューマーグループなどのKafkaメトリクスを収集し、OTLP形式に変換します。	メトリクス
Kubernetes クラスターレシーバー（`k8s_cluster`）	Kubernetes API サーバーからクラスターレベルのメトリクスを収集します。更新をリッスンするために Kubernetes API を使用します。このレシーバーの単一インスタンスを使用してクラスターを監視できます。	メトリクス
Kubernetes イベントレシーバー（`k8s_events`）	Kubernetes API サーバーからすべての新しいイベントと更新されたイベントを収集します。このレシーバーは、サービスアカウントによる認証にのみ対応しています。	ログ
Kubernetes オブジェクトレシーバー（`k8sobjects`）	Kubernetes API サーバーからオブジェクトを収集します。このレシーバーは、サービスアカウントによる認証にのみ対応しています。	ログ
Kubelet 統計レシーバー（`kubeletstats`）	kubelet上のAPIサーバーからPodのメトリクスをプルします。	メトリクス
MongoDB レシーバー（`mongodb`）	Golang `mongo` ドライバを使って MongoDB インスタンスから統計情報を取得します。	メトリクス
MongoDB Atlas レシーバー（`mongodbatlas`）	MongoDB Atlas の監視 API を使って、MongoDB Atlas からメトリクスを取得します。	メトリクス
Microsoft SQL Server レシーバー（`sqlserver`）	Microsoft SQL Server インスタンスからメトリクスを取得します。	メトリクス
MySQL レシーバー（`mysql`）	MySQL のグローバルステータスと InnoDB テーブルに関するメトリクスをクエリして取得します。	メトリクス
NGINX レシーバー（`nginx`）	`ngx_http_stub_status_module` モジュールのステータスエンドポイントを使って、NGINX インスタンスから統計情報を取得します。	メトリクス
Oracle Database レシーバー（`oracledb`）	Oracle Database インスタンスに接続し、物理読み込み、CPU、時間などのメトリクスを取得します。	メトリクス
OTLP レシーバー（`otlp`）	OTLPフォーマットでgRPCまたはHTTP経由でデータを受信します。	メトリクス、ログ、トレース
PostgreSQL レシーバー（`postgresql`）	PostgreSQL の統計情報を取得します。PostgreSQL バージョン 9.6 以降をサポートしています。	メトリクス
Prometheus レシーバー（`prometheus`）	単一のターゲットからメトリクスをスクレイピングするためのシンプルな構成インターフェイスを提供します。	メトリクス
Simple Prometheus レシーバー（`prometheus_simple`）	`prometheus` レシーバーをラップし、単一ターゲットの設定を簡素化します。	メトリクス
Pure Storage FlashArray レシーバー（`purefa`）	Pure Storage FlashArrayからメトリクスを受け取ります。	メトリクス
RabbitMQ レシーバー（`rabbitmq`）	RabbitMQ Management Pluginを使用してRabbitMQノードから統計情報を取得します。	メトリクス
レシーバークリエータレシーバー（`receiver_creator`）	確認されたエンドポイントが構成されたルールと一致するかどうかに基づいて、ランタイム時に他のレシーバーをインスタンス化します。レシーバークリエータを使用するには、1 つ以上のオブザーバ拡張機能を構成してネットワーク化されたエンドポイントを検出します。	N/A
Redis レシーバー（`redis`）	特定の Redis インスタンスから Redis `INFO` データを取得し、そこからメトリクスを構築します。	メトリクス
Splunk APM（SAPM）レシーバー（非推奨）（`sapm`）	他のコレクタまたは SignalFx Smart Agent からトレースを受信します。	トレース
SignalFx Gateway Prometheus リモート書き込みレシーバー（`signalfxgatewayprometheusremotewritereceiver`）	SignalFx Prometheusリモート書き込みゲートウェイのOTelネイティブバージョン。	メトリクス
SignalFx レシーバー（`signalfx`）	proto フォーマットのメトリクスとログを受け取ります。	メトリクス、ログ
Smart Agent レシーバー（`smartagent`）	既存の Smart Agent モニターを Collector メトリクスレシーバーとして使用します。詳細については、「Collector でSmart Agent モニターを使用する」を参照してください。	メトリクス
Snowflake レシーバー（`snowflake`）	Snowflakeデプロイメントに接続してクエリすることにより、Snowflakeアカウントからメトリクスを収集します。	メトリクス
Splunk Enterprise レシーバー（`splunkenterprise`）	ユーザーの Splunk Enterprise デプロイメントの運用状況を示すパフォーマンスメトリクスの取り込みを可能にします。	メトリクス
Splunk HEC レシーバー（`splunk_hec`）	Splunk HEC 形式のテレメトリを受け付けます。	メトリクス、ログ、トレース
SQL Query レシーバー（`sqlquery`）	カスタム SQL クエリを実行して、データベース接続からメトリクスを生成します。	メトリクス
SSH チェックレシーバー（`sshcheck`）	SSH サーバー (SFTP サーバーの可能性があります) に接続して統計情報を作成します。	メトリクス
StatsD レシーバー（`statsd`）	StatsDメッセージを収集し、メトリクスを生成します。	メトリクス
Syslog レシーバー（`syslog`）	TCPまたはUDPで受信したsyslogメッセージを解析します。	ログ
TCP ログレシーバー（`tcplog`）	TCPでログを受信します。	ログ
UDP ログレシーバー（`udplog`）	UDPでログを受信します。	ログ
vCenter レシーバー（`vcenter`）	ESXi および vCenter をサポートします。	メトリクス
Wavefront レシーバー（`wavefront`）	メトリクスを受け入れ、`carbon` レシーバーの proto とトランスポートに依存します。	メトリクス
Windows イベントログレシーバー（`windowseventlog`）	WindowsイベントログAPIからのログを解析します。	ログ
Windows Performance Counters レシーバー（`windowsperfcounters`）（Windows のみ）	構成されたシステム、アプリケーション、またはカスタム・パフォーマンス・カウンターのデータをWindowsレジストリから収集します。	メトリクス
Zipkin レシーバー（`zipkin`）	Zipkin・バージョン1と2のスパンを受信します。	トレース

プロセッサー


Name	説明	パイプラインの種類
属性プロセッサ（`attributes`）	スパンまたはログレコードの属性を変更します。	ログ、トレース
バッチプロセッサ（`batch`）	スパン、メトリック、またはログを受け入れ、バッチに配置します。バッチ化することで、データをより適切に圧縮し、データ伝送に必要な発信接続数を減らすことができます。このプロセッサは、サイズベースと時間ベースの両方のバッチ化をサポートします。	メトリクス、ログ、トレース
デルタプロセッサへの累積（`cumulativetodelta`）	累積単調メトリックをデルタ集約の時間特性に変換します。この変換により、Splunk Observability Cloud での累積メトリクスの使用が強化されます。	メトリクス
フィルタプロセッサ（`filter`）	`strict` または `regexp` マッチ・タイプの場合はメトリクス名に基づいて、`expr` マッチ・タイプの場合はその他のメトリクス属性に基づいて、メトリクスを包含または除外するように構成できます。	メトリクス
属性プロセッサによるグループ化（`groupbyattrs`）	スパン、ログレコード、およびメトリックデータポイントを、指定された属性と一致するリソースに再関連付けします。その結果、指定された属性に同じ値を持つすべてのスパン、ログレコード、またはメトリクスデータポイントが同じリソースの下にグループ化されます。	メトリクス、ログ、トレース
Kubernetes 属性プロセッサ（`k8sattributes`）	スパン、メトリクス、ログに Kubernetes のメタデータを自動的にタグ付けできます。旧 `k8s_tagger`。	メトリクス、ログ、トレース
Memory Limiter プロセッサ（`memory_limiter`）	Splunk Distribution of OpenTelemetry Collector でのメモリ不足を防止します。	メトリクス、ログ、トレース
メトリクス生成プロセッサー（`metricsgeneration`）	特定のルールに続いて既存のメトリクスを使用して新しいメトリクスを作成します。	メトリクス
メトリクス変換プロセッサ（`metricstransform`）	メトリクスの名前を変更し、ラベル・キーと値を追加、変更、または削除します。	メトリクス
Probabilistic サンプラープロセッサ（`probabilisticsampler`）	スパンおよびログレコードのサンプリングに複数のモードをサポートします。	トレース、ログ
編集プロセッサ（`redaction`）	許可された属性のリストに一致しないスパン属性を削除します。また、ブロックされた値リストにマッチするスパン属性値をマスクします。	トレース
リソースプロセッサ（`resource`）	リソース属性に変更を適用します。属性は、リソースに適用できるアクションを表します。	メトリクス、ログ、トレース
リソース検出プロセッサ（`resourcedetection`）	ホストからのリソース情報を、OpenTelemetry リソースの意味上の規約に準拠したフォーマットで検出し、テレメトリデータのリソース値をこの情報で追加または上書きします。	メトリクス、ログ、トレース
ルーティングプロセッサ（非推奨）（`routing`）	受信 HTTP リクエストからヘッダーを読み取るか、リソース属性を読み取り、その値に基づいてトレース情報を特定のエクスポーターに向けます。	メトリクス、ログ、トレース
スパンプロセッサ（`span`）	スパン名またはスパン名に基づくスパンの属性を変更します。	トレース
テールサンプリングプロセッサ（`tail_sampling`）	定義された一連のポリシーに基づいてトレースをサンプリングします。与えられたトレースのすべてのスパンは、効果的なサンプリング決定のために同じ Collector インスタンスによって受信される必要があります。	トレース
変換プロセッサ（`transform`）	OpenTelemetry Transformation Language 関数に基づいてテレメトリを変更します。	メトリクス、ログ、トレース

エクスポーター


Name	説明	パイプラインの種類
AWS S3 エクスポータ（`awss3`）	このエクスポータは proto/json 形式をサポートすることを目標としています。	メトリクス、ログ、トレース
ファイルエクスポータ（`file`）	パイプラインのデータを、OpenTelemetry プロトコルを使用して、Protobuf JSON エンコーディングの JSON ファイルに書き込みます。	メトリクス、ログ、トレース
Kafka エクスポータ（`kafka`）	同期プロデューサーを使用して、メトリクス、ログ、トレースをKafkaにエクスポートします。	メトリクス、ログ、トレース
ロードバランシングエクスポータ（`loadbalancing`）	メトリクス、ログ、トレースをさまざまなバックエンドにエクスポートします。	メトリクス、ログ、トレース
ログエクスポータ（`logging`）	コンソールにデータをエクスポートします。デフォルトでは、`logging` は Windows Event Viewer に出力を送信しません。Windows Event Viewer に出力を送信するには、PowerShell ターミナルから Splunk Distribution of OpenTelemetry Collector を直接実行します。	メトリクス、ログ、トレース
OTLP エクスポータ（`otlp`）	OTLP 形式を使用して gRPC でデータをエクスポートします。デフォルトでは、このエクスポータは TLS を必要とし、キュー再試行機能を提供します。	メトリクス、ログ、トレース
OTLP/HTTP エクスポータ（`otlphttp`）	HTTPプロトコルでOTLP形式のデータをエクスポートします。	メトリクス、ログ、トレース
Pulsar エクスポータ（`pulsar`）	ログ、メトリクス、トレースを Pulsar へエクスポートします。	メトリック、ログ、トレース -
SignalFx エクスポータ（`signalfx`）	メトリクス、イベント、トレース相関を Splunk Observability Cloud に送信します。	ログ（イベント）、メトリクス、トレース（トレースとメトリクスの相関のみ）
Splunk APM（SAPM）エクスポータ（非推奨）（`sapm`）	複数のノードまたはサービスのトレースを一括してエクスポートします。	トレース
Splunk HEC エクスポータ（`splunk_hec`）	テレメトリを Splunk HEC エンドポイントに送信します。	メトリクス、ログ、トレース

エクステンション


Name	説明
Basicauth 拡張機能（`basicauth`）	`configauth.ServerAuthenticator`、`configauth.ClientAuthenticator` の両方を実装し、ベーシック認証でクライアントとサーバーを認証します。認証タイプを `basicauth` に設定する必要があります。
Authenticator - Bearer 拡張機能（`bearertokenauth`）	`configauth.ServerAuthenticator` と `configauth.ClientAuthenticator` の両方を実装します。http と gRPC の両方のエクスポータで `auth` 設定内で使用して、RPC コールのたびに静的トークンを埋め込むことができます。
Docker Observer 拡張機能（`docker_observer`）	Docker API を通じて確認されたコンテナエンドポイントを検出し、レポートします。 `Running` で `Paused` ではない状態のコンテナのみがエンドポイントを出力します。
ECS Observer 拡張機能（`ecs_observer`）	ECS と EC2 の API を使用して、実行中のすべてのタスクから Prometheus のスクレイプターゲットを検出し、サービス名、タスク定義、コンテナラベルに基づいてフィルタリングします。Prometheus レシーバーーとのみ互換性があります。
ECS タスクオブザーバ拡張機能（`ecs_task_observer`）	Collector インスタンスがメンバーである実行中の ECS タスクのコンテナエンドポイントを検出してレポートします。
ファイルストレージ拡張機能（`file_storage`）	ローカルファイルシステムに状態を永続化します。ディクショナリに対する読み取りおよび書き込みアクセス権が必要です。
正常性チェック拡張機能（`health_check`）	OpenTelemetry Collector のステータスを確認するために、プローブできる HTTP URL を有効化します。この拡張機能を Kubernetes の稼働状況または準備状況のプローブとして使用することもできます。
HTTP フォワーダー拡張機能（`http_forwarder`）	HTTP リクエストを受け付け、オプションでヘッダーを追加して転送します。元の要求の RequestURI は、拡張機能によって保持されます。
ホストオブザーバ拡張機能（`host_observer`）	リッスンしているネットワークエンドポイントについて、現在のホストを調べます。/proc ファイルシステムを使用し、どのプロセスがリッスン状態のソケットを所有しているかを判断できるように、`SYS_PTRACE` と `DAC_READ_SEARCH` の機能が必要です。詳しくは「Receiver creator receiver」を参照してください。
Kubernetes オブザーバ拡張機能（`k8s_observer`）	Kubernetes API を使用して、ローカルノードで動作しているポッドを検出します。詳しくは「Receiver creator receiver」を参照してください。
Memory Ballast 拡張機能（非推奨）（`memory_ballast`）	`memory_ballast` は廃止されました。この拡張機能を使用している場合は、設定を更新する方法を参照してください。
OAuth2 Client Auth 拡張機能（`oauth2client`）	HTTPおよびgRPCベースのエクスポーターにOAuth2クライアント認証情報のフローを提供します。
Pprof オブザーバ拡張機能（`pprof`）	golang `net/http/pprof` エンドポイントを有効にします。このエンドポイントは、パフォーマンスプロファイルを収集し、サービスの問題を調査するために使用されます。
Smart Agent 拡張機能（`smartagent`）	Smart Agent レシーバーのすべてのインスタンスに適用される設定オプションを設定するメカニズムを提供します。既存の Smart Agent の設定を Splunk Distribution of OpenTelemetry Collector に移行できます。
zPages 拡張機能（`zpages`）	さまざまなコンポーネントをデバッグするためのライブデータを提供する HTTP エンドポイントである zPages を提供する拡張機能を有効にします。

コネクター

コネクタはさまざまなパイプラインを接続し、接続間でテレメトリデータを送信できるようにします。コネクタは、あるパイプラインへのエクスポータおよび別のパイプラインへのレシーバーとして機能します。

OpenTelemetry Collector の各パイプラインは、1 つのタイプのテレメトリデータに作用します。ある形式のテレメトリデータを別の形式に処理する必要があるときは、適切なコレクタパイプラインにデータをルーティングします。


Name	説明	パイプラインの種類
Routing コネクタ（`routing`）	OpenTelemetry Transformation Language (OTTL)のステートメントをルーティング条件として使用して、リソース属性に基づいてログ、メトリクス、トレースを特定のパイプラインにルーティングします。	トレース、メトリクス、ログ
Span Metrics コネクタ（`spanmetrics`）	スパンデータからリクエスト、エラー、期間（R.E.D OpenTelemetry メトリクスを集計します。	トレース、メトリクス
Sum コネクタ（`sum`）	スパン、スパンイベント、メトリクス、データポイント、ログレコードの属性値を合計します。	トレース、メトリクス、ログ

次のステップ

以下のドキュメントを参照してください: