Docs » Splunk Observability Cloud でサポートされているインテグレーション » Collectorコンポーネント: レシーバー » OTLPレシーバー

OTLPレシーバー 🔗

OTLP レシーバーを使用すると、Collector は OTLP フォーマットを使用して gRPC または HTTP でデータを受信できます。サポートされているパイプラインは tracesmetrics 、および logs です。詳細は パイプラインでデータを処理する を参照してください。

OTLPフォーマットについての詳細は、OTel repo OpenTelemetry Protocol Specification を参照してください。

注釈

OTLP エクスポーターについては、OTLPエクスポーター を参照してください。

はじめに 🔗

注釈

このコンポーネントは、Splunk Distribution of the OpenTelemetry Collector のデフォルト設定に含まれています。

デフォルト設定の詳細については、Helmで Collector for Kubernetes を設定するCollector for Linux のデフォルト設定、または Collector for Windows のデフォルト設定 を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:

  1. Splunk Distribution of the OpenTelemetry Collectorをホストまたはコンテナプラットフォームにデプロイします。はじめに:Collectorを理解して使用する を参照してください。

  2. 次のセクションで説明するように、OTLP受信機を設定します。

  3. Collector を再起動します。

サンプル構成 🔗

OTLP レシーバーをアクティブにするには、以下の設定例のように、コレクター設定ファイルの receivers セクションに otlp を追加します:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: "${HOST_LISTEN_INTERFACE}:1234"
      http:
        endpoint: "${HOST_LISTEN_INTERFACE}:5678"

レシーバーがデータを受信する、endpoint または host:port を指定することができます。

  • endpoint のデフォルト値は 0.0.0.0:4317 for gRPCです

  • endpoint のデフォルト値は 0.0.0.0:4318 for HTTP です

有効な構文については、gRPC名前解決 を参照してください。

次に、受信したいデータタイプの設定ファイルのサービスパイプラインのセクションに、レシーバーを追加します:

service:
  pipelines:
    traces:
      receivers: [otlp]
    metrics:
      receivers: [otlp]

高度な設定 🔗

ヘルパーファイルを使用して、自動的に追加機能を提供できます。詳細は、共通設定オプション を参照してください。

Protobufペイロード 🔗

OTLPはgRPCとHTTPで実装され、ペイロードにはプロトコルバッファのスキーマを使います。

Protocol Buffersは、構造化データをシリアライズする不可知論的なメカニズムです。データをどのように構造化したいかを一度定義すれば、あとは特別に生成されたソースコードを使って、さまざまな言語を使って構造化データを書いたり読んだりすることができます。

詳しくは Protocol Buffers documentation を参照してください。

OTLP/gRPC の操作 🔗

gRPCを使用する場合、基礎となる gRPCトランスポートを確立した後、OTLPレシーバーはテレメトリデータのリクエストを継続的に受信し始め、各リクエストに応答する必要があります。詳細については、OTLP/gRPC Specification にある公式OpenTelemetryドキュメントを参照してください。これには、リクエスト、レスポンス、OTLP/gRPCスロットリングの詳細が含まれます。

OTLP/HTTP の操作 🔗

HTTP を使用する場合、Protobuf ペイロードはバイナリまたは JSON 形式でエンコードできます。OTLP/HTTP は、HTTP POST リクエストを使用して、テレメトリデータをレシーバーに送信します。詳細については、OTLP/HTTP Specification の公式 OpenTelemetry ドキュメントを参照してください。これには、エンコーディング、リクエスト、レスポンス、スロットリングの詳細が含まれます。

OTLP/HTTP設定は、traces_url_pathmetrics_url_pathlogs_url_path の設定も提供し、シグナルデータを送信する必要があるURLパスをシグナルタイプごとに変更できるようにします。これらのデフォルトはそれぞれ /v1/traces/v1/metrics/v1/logs です。

HTTPでトレースを書き込むには、[address]/[traces_url_path] (トレース用)、[address]/[metrics_url_path] (メトリクス用)、[address]/[logs_url_path] (ログ用)にPOSTします。

OTLP/HTTP エクスポーターでの作業 🔗

このコンポーネントとの通信に otlphttpexporter ピアを使用する場合は、otlphttpexportertraces_endpointmetrics_endpointlogs_endpoint の各設定を使用して、otlpreceiver のアドレスと URL シグナルパスに一致する適切な URL を設定します。

詳細は、OTLP/HTTP エクスポーター を参照してください。

クロスオリジンリソースシェアリング(CORS)の使用 🔗

HTTP エンドポイントは、オプションで cors: の下で CORS を設定することもできます:

  • allowed_origins を使って、どのオリジン(またはワイルドカードパターン)からのリクエストを許可するかを指定します。

  • デフォルトのセーフリスト以外のリクエストヘッダーを許可するには、allowed_headers を設定します。

  • max_age を設定して、プリフライトリクエストに対するレスポンスをキャッシュするようにブラウザに指示します。

詳しくは https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS を参照してください。

以下のサンプル設定を参照してください:

receivers:
  otlp:
    protocols:
      http:
        endpoint: "localhost:4318"
        cors:
          allowed_origins:
            - http://test.com
            # Origins can have wildcards with *, use * by itself to match any origin.
            - https://*.example.com
          allowed_headers:
            - Example-Header
          max_age: 7200

設定 🔗

次の表は、OTLPレシーバーの設定オプションを示しています:

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

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