Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector コンポーネント

Collector コンポーネント 🔗

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

  • レシーバー: 複数のソースから Collector にデータを取得します。

  • プロセッサー ：エクスポートされる前にデータに対して処理を行います。例えば、フィルターリングなど。

  • エクスポーター: 1つまたは複数のバックエンドまたは宛先にデータを送信します。

  • 拡張 ： Collector の機能を拡張します。

  • Connectors: Send telemetry data between different collector pipelines.

Collector 設定で サービスパイプライン を設定することで、コンポーネントをアクティブ化できます。コンポーネントの複数のインスタンスとそのパイプラインを定義する方法については、はじめに：Collectorを理解して使用する を参照してください。

The Splunk Distribution of the OpenTelemetry Collector includes and supports the components listed on this doc.

注釈

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

Receivers

Name

説明

パイプラインの種類

Apache Web Server receiver (apache)

Fetches stats from a Apache Web Server.

メトリクス

Apache Spark receiver (apachespark)

Apache Spark REST APIを通じてApache Sparkクラスターのメトリクスを取得します。

メトリクス

AWS ECS container metrics receiver (awsecscontainermetrics)

Amazon ECSからタスクメタデータとdocker統計を読み込み、リソース使用量のメトリクスを生成します。

メトリクス

Azure イベントハブレシーバー ( azureeventhub )

Azure イベントハブからログをプルします。

ログ

Carbon レシーバー ( carbon )

Carbon プレーンテキストプロトコルでメトリクスを受信します。

メトリクス

Chrony receiver (chrony)

システムやプラットフォーム間の移植性を追跡する chronyc コマンドのGo実装。

メトリクス

Cloud Foundry レシーバー ( cloudfoundry )

Cloud FoundryのRLP（Reverse Log Proxy）ゲートウェイに接続し、メトリクスを抽出します。

メトリクス

CollectD レシーバー ( collectd )

CollectD write_http プラグインからエクスポートされたデータを受信します。JSON形式のみサポートします。

メトリクス

ディスカバリーレシーバー (discovery) elasticsearch-receiver

メトリクス収集ターゲットの発見を容易にするために、レシーバークリエーターをラップします。Automatic discovery of apps and services を参照してください。

ログ

Elasticsearch receiver (elasticsearch)

Elasticsearchノード時計、クラスター健全性、インデックス統計エンドポイントに問い合わせて、稼働中のElasticsearchクラスターからメトリクスをスクレイピングします。

メトリクス

Filelog レシーバー ( filelog )

ファイルからのログを追尾し、解析します。

ログ

Fluent Forward レシーバー ( fluentforward )

Fluentd Forward プロトコルでイベントを受け取る TCP サーバーを実行します。

ログ

HAProxy receiver (haproxy)

専用ソケットまたはHTTP URLを介してHAProxyプロセスを定期的にポーリングすることで、メトリクスを生成します。

メトリクス

ホスト・メトリクス・レシーバー ( hostmetrics )

さまざまなソースからシステム・メトリクスを生成します。Collectorをエージェントとしてデプロイする場合は、このレシーバーを使用します。

メトリクス

HTTP check receiver (httpcheck)

HTTPエンドポイントに対して合成チェックを実行します。

メトリクス

Jaeger レシーバー ( jaeger )

Jaeger 形式のトレースデータを受信します。

トレース

JMXレシーバー ( jmx )

MBean サーバーからメトリクスをレポートするために、OpenTelemetry JMX Metric Gatherer と連携して動作します。

メトリクス

Journald レシーバー ( journald )

systemd ジャーナルから 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 receiver (sqlserver)

Grabs metrics from a Microsoft SQL Server instance.

メトリクス

MySQL レシーバー ( mysql )

MySQL のグローバルステータスと InnoDB テーブルに関するメトリクスをクエリして取得します。

メトリクス

NGINX receiver (nginx)

Fetches stats from a NGINX instance using the ngx_http_stub_status_module module’s status endpoint.

メトリクス

Oracle Databaseレシーバー ( oracledb )

Oracle Database インスタンスに接続し、物理読み込み、CPU、時間などのメトリクスを取得します。

メトリクス

OTLPレシーバー ( otlp )

OTLPフォーマットでgRPCまたはHTTP経由でデータを受信します。

メトリクス、ログ、トレース

PostgreSQLレシーバー ( postgresql )

PostgreSQL統計情報コレクタに問い合わせます。PostgreSQL バージョン 9.6 以降をサポートしています。

メトリクス

Prometheusレシーバー ( prometheus )

単一のターゲットからメトリクスをスクレイピングするためのシンプルな構成インターフェイスを提供します。

メトリクス

シンプルなPrometheusレシーバー ( prometheus_simple )

prometheus レシーバーをラップし、単一ターゲットの設定を簡素化します。

メトリクス

RabbitMQ receiver (rabbitmq)

RabbitMQ Management Pluginを使用してRabbitMQノードから統計情報を取得します。

メトリクス

レシーバークリエーターレシーバー ( receiver_creator )

観測されたエンドポイントが設定されたルールに一致するかどうかに基づいて、実行時に他のレシーバーをインスタンス化します。レシーバークリエーターを使用するには、1つ以上のオブザーバー拡張を設定して、ネットワーク接続されたエンドポイントを検出します。

N/A

Redis レシーバー ( redis )

特定の Redis インスタンスから Redis INFO データを取得し、そこからメトリクスを構築します。

メトリクス

SAPM レシーバー ( sapm )

他のコレクタまたは SignalFx Smart Agent からトレースを受信します。

トレース

SignalFx Gateway Prometheus remote write receiver (signalfxgatewayprometheusremotewritereceiver)

SignalFx Prometheusリモート書き込みゲートウェイのOTelネイティブバージョン。

メトリクス

SignalFxレシーバー ( signalfx )

proto フォーマットのメトリクスとログを受け取ります。

メトリクス、ログ

Smart Agent レシーバー ( smartagent )

既存のSmart Agent モニターを Collector メトリクスレシーバーとして使用します。詳しくは Collector でSmart Agent モニターを使用する を参照してください。

メトリクス

Splunk Enterprise receiver (splunkenterprise)

ユーザーのSplunk Enterpriseデプロイの運用状況を示すパフォーマンスメトリクスの取り込みを可能にします。

メトリクス

Splunk HEC レシーバー ( splunk_hec )

Splunk HEC 形式のテレメトリを受け付けます。

メトリクス、ログ、トレース

SQLクエリレシーバー ( sqlquery )

カスタム SQL クエリを実行して、データベース接続からメトリクスを生成します。

メトリクス

SSH チェックレシーバー ( sshcheck )

SSH サーバー (SFTP サーバーの可能性があります) に接続して統計情報を作成します。

メトリクス

StatsD レシーバー ( statsd )

StatsDメッセージを収集し、メトリクスを生成します。

メトリクス

Syslog レシーバー ( syslog )

TCPまたはUDPで受信したsyslogメッセージを解析します。

ログ

TCPログレシーバー ( tcplog )

TCPでログを受信します。

ログ

UDPログレシーバー ( udplog )

UDPでログを受信します。

ログ

Jaeger レシーバー ( vcenter )

ESXi および vCenter をサポートします。

メトリクス

Wavefront レシーバー ( wavefront )

メトリクスを受け入れ、carbon レシーバーの proto とトランスポートに依存します。

メトリクス

Windows イベントログレシーバー ( windowseventlog )

WindowsイベントログAPIからのログを解析します。

ログ

Windowsパフォーマンス・カウンターレシーバー ( windowsperfcounters ) （Windowsのみ）

構成されたシステム、アプリケーション、またはカスタム・パフォーマンス・カウンターのデータをWindowsレジストリから収集します。

メトリクス

Zipkinレシーバー ( zipkin )

Zipkin・バージョン1と2のスパンを受信します。

トレース

Processors

Name

説明

パイプラインの種類

属性プロセッサー ( attributes )

スパンまたはログレコードの属性を変更します。

ログ、トレース

バッチプロセッサー ( batch )

スパン、メトリクス、またはログを受け入れ、それらをバッチに配置します。バッチ化することで、データをより適切に圧縮し、データ伝送に必要な発信接続数を減らすことができます。このプロセッサーは、サイズ・ベースのバッチ処理と時間ベースのバッチ処理の両方をサポートします。

メトリクス、ログ、トレース

Delta プロセッサーへの累積 ( cumulativetodelta )

累積単調メトリクスをデルタ集計の一時性に変換します。これにより、Splunk Observability Cloud での累積メトリクスの利用が向上します。

メトリクス

フィルタープロセッサー ( filter )

strict または regexp マッチ・タイプの場合はメトリクス名に基づいて、expr マッチ・タイプの場合はその他のメトリクス属性に基づいて、メトリクスを包含または除外するように構成できます。

メトリクス

属性プロセッサーによるグループ化 ( groupbyattrs )

スパン、ログ・レコード、およびメトリクス・データポイントを、指定された属性に一致するリソースに関連付け直します。その結果、指定された属性に同じ値を持つすべてのスパン、ログ・レコード、またはメトリクス・データポイントが同じリソースの下にグループ化されます。

メトリクス、ログ、トレース

Kubernetes属性プロセッサー ( k8sattributes )

スパン、メトリクス、ログにKubernetesのメタデータを自動的にタグ付けできます。以前は k8s_tagger として知られていました。

メトリクス、ログ、トレース

メモリリミッタープロセッサー ( memory_limiter )

Splunk Distribution of OpenTelemetry Collector でのメモリ不足を防止します。

メトリクス、ログ、トレース

メトリクストランスフォームプロセッサー ( metricstransform )

メトリクスの名前を変更し、ラベル・キーと値を追加、変更、または削除します。

メトリクス

Probabilistic サンプラープロセッサー ( probabilisticsampler )

スパンおよびログレコードのサンプリングに複数のモードをサポートします。

Traces, logs

Redaction processor (redaction)

許可された属性のリストと一致しないスパン属性を削除します。また、ブロックされた値リストと一致するスパン属性の値をマスクします。

トレース

リソースプロセッサー ( resource )

リソース属性に変更を適用します。属性は、リソースに適用できるアクションを表します。

メトリクス、ログ、トレース

リソース検出プロセッサー ( resourcedetection )

ホストからのリソース情報を、OpenTelemetry リソースの意味上の規約に準拠したフォーマットで検出し、テレメトリデータのリソース値をこの情報で追加または上書きします。

メトリクス、ログ、トレース

ルーティングプロセッサー ( routing )

受信 HTTP リクエストからヘッダーを読み取るか、リソース属性を読み取り、その値に基づいてトレース情報を特定のエクスポーターに向けます。

メトリクス、ログ、トレース

スパンプロセッサー ( span )

スパン名またはスパン名に基づくスパンの属性を変更します。

トレース

テールサンプリングプロセッサー ( tail_sampling )

定義されたポリシーのセットに基づいてトレースをサンプリングします。与えられたトレースのすべてのスパンは、効果的なサンプリング決定のために同じCollectorインスタンスによって受信される必要があります。

トレース

トランスフォームプロセッサー ( transform )

OpenTelemetry Transformation Language 関数に基づいてテレメトリを変更します。

メトリクス、ログ、トレース

Exporters

Name

説明

パイプラインの種類

AWS S3 エクスポーター ( awss3 )

このエクスポータは proto/json 形式をサポートすることを目標としています。

メトリクス、ログ、トレース

ファイルエクスポーター ( file )

パイプラインのデータを、OpenTelemetry プロトコルを使用して、Protobuf JSON エンコーディングの JSON ファイルに書き込みます。

メトリクス、ログ、トレース

Kafka エクスポーター ( kafka )

同期プロデューサーを使用して、メトリクス、ログ、トレースをKafkaにエクスポートします。

メトリクス、ログ、トレース

ロードバランシングエクスポーター ( loadbalancing )

メトリクス、ログ、トレースをさまざまなバックエンドにエクスポートします。

メトリクス、ログ、トレース

ログエクスポーター ( logging )

コンソールにデータをエクスポートします。デフォルトでは、logging は Windows イベントビューアに出力を送信しません。Windows イベントビューアに出力を送信するには、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 )

複数のノードまたはサービスのトレースを一括してエクスポートします。

トレース

Splunk HEC エクスポーター ( splunk_hec )

テレメトリを Splunk HEC エンドポイントに送信します。

メトリクス、ログ、トレース

Extensions

Name

説明

Basicauth 拡張 ( basicauth )

configauth.ServerAuthenticator 、configauth.ClientAuthenticator の両方を実装し、ベーシック認証でクライアントとサーバーを認証します。認証タイプは basicauth に設定する必要があります。

Docker オブザーバーエクステンション ( docker_observer )

Docker APIを通じて発見されたコンテナエンドポイントを検出し、報告します。Paused ではなく、Running の状態にあるコンテナだけがエンドポイントを発行します。

ECS オブザーバーエクステンション ( 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 の機能が必要です。詳細は レシーバークリエーターレシーバー を参照してください。

Kubernetes オブザーバーエクステンション ( k8s_observer )

Kubernetes APIを使用して、ローカルノードで実行されているPodを検出します。詳細は レシーバークリエーターレシーバー を参照してください。

メモリバラストエクステンション (非推奨) ( memory_ballast )

memory_ballast is deprecated. If you’re using this extension, see how to update your configuration.

OAuth2 Client Auth extension (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 を提供する拡張機能を有効にします。

Connectors

コネクターは異なるパイプラインを接続し、パイプライン間でテレメトリ データを送信するのに役立ちます。コネクターは、あるパイプラインへのエクスポーターと別のパイプラインへのレシーバーの役割を果たします。

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

Name

説明

パイプラインの種類

Span Metrics connector (spanmetrics)

スパンデータからリクエスト、エラー、期間（R.E.D OpenTelemetry メトリクスを集計します。

トレース、メトリクス

Next steps

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

このページは 2024年11月20日 に最終更新されました。