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

説明

パイプラインの種類

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

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

ログ

Carbon レシーバー ( carbon )

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

メトリクス

Cloud Foundry レシーバー ( cloudfoundry )

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

メトリクス

CollectD レシーバー ( collectd )

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

メトリクス

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

メトリクス収集ターゲットの発見を容易にするために、レシーバークリエーターをラップします。Discover telemetry sources automatically を参照してください。

ログ

Filelog レシーバー ( filelog )

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

ログ

Fluent Forward レシーバー ( fluentforward )

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

ログ

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

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

メトリクス

HTTP check receiver (httpcheck)

Performs synthethic checks against HTTP endpoints.

メトリクス

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 テーブルに関するメトリクスをクエリして取得します。

メトリクス

Oracle Databaseレシーバー ( oracledb )

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

メトリクス

OTLPレシーバー ( otlp )

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

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

PostgreSQLレシーバー ( postgresql )

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

メトリクス

Prometheusレシーバー ( prometheus )

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

メトリクス

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

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

メトリクス

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

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

N/A

Redis レシーバー ( redis )

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

メトリクス

SAPM レシーバー ( sapm )

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

トレース

SignalFxレシーバー ( signalfx )

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

メトリクス、ログ

Smart Agent レシーバー ( smartagent )

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

メトリクス

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 )

Supports several modes of sampling for spans and log records.

Traces, logs

Redaction processor (redaction)

Deletes span attributes that don’t match a list of allowed attributes. It also masks span attribute values that match a blocked value list.

トレース

リソースプロセッサー ( 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.ServerAuthenticatorconfigauth.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_PTRACEDAC_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)

Provides OAuth2 Client Credentials flow authenticator for HTTP and gRPC based exporters.

Pprof オブザーバーエクステンション ( pprof )

golang net/http/pprof エンドポイントを有効にします。このエンドポイントは、パフォーマンスプロファイルを収集し、サービスの問題を調査するために使用されます。

Smart Agent ・エクステンション ( smartagent )

Smart Agent レシーバーのすべてのインスタンスに適用可能な設定オプションを設定するメカニズムを提供します。既存の Smart Agent 設定を Splunk Distribution of OpenTelemetry Collector に移行できます。

zPagesエクステンション ( zpages )

さまざまなコンポーネントをデバッグするためのライブデータを提供する HTTP エンドポイントである zPages を提供する拡張機能を有効にします。

Connectors

A connector connects different pipelines and helps you send telemetry data between them. A connector acts as an exporter to one pipeline and a receiver to another.

Each pipeline in the OpenTelemetry Collector acts on one type of telemetry data. If you need to process one form of telemetry data into another one, route the data accordingly to its proper collector pipeline.

Name

説明

パイプラインの種類

Span Metrics connector (spanmetrics)

Aggregates Request, Error and Duration (R.E.D) OpenTelemetry metrics from span data.

トレース、メトリクス

Next steps

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

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