Splunk APMで互換性を持つスパン形式

Splunk APMのさまざまなスパン形式について学習します。

Splunk APM は、トレースデータを送受信するエージェント、コレクター、エンドポイントに応じて、さまざまなスパン形式をサポートしています。Splunk APM のアプリケーションのインストゥルメント化の詳細については、「アプリケーションとサービスをインストゥルメントして、Splunk APMにスパンを取り込む」を参照してください。

取り込み API エンドポイントの詳細については、「APM のトレースの送信」を参照してください。

OpenTelemetry Collectorで互換性を持つスパン形式

Splunk Distribution of OpenTelemetry Collectorでは、以下の形式のスパンを収集できます：

  • Jaeger：gRPCおよびThrift

  • Zipkin v1、v2 JSON

  • OpenTelemetryプロトコル（OTLP）

注: Splunk APM Protocol（SAPM）コンポーネントは非推奨です。代わりに OTLP フォーマットを使用してください。

以下の例は、コレクターの構成ファイルでレシーバーを構成する方法を示したものです。必要に応じて複数のレシーバーを使用できます。

Jaeger Thrift
# To receive spans in Jaeger Thrift format

receivers:
   jaeger:
      protocols:
         grpc:
            endpoint: 0.0.0.0:14250
         thrift_binary:
            endpoint: 0.0.0.0:6832
         thrift_compact:
            endpoint: 0.0.0.0:6831
         thrift_http:
            endpoint: 0.0.0.0:14268
Zipkin
# To receive spans in Zipkin format

receivers:
   zipkin:
      endpoint: 0.0.0.0:9411
OTLP
# To receive spans in OTLP format

receivers:
   otlp:
      protocols:
         grpc:
            endpoint: 0.0.0.0:4317
         http:
            endpoint: 0.0.0.0:4318

コレクタ設定の詳細については、「はじめに：Collector を理解して使用する」を参照してください。

取り込みエンドポイントと互換性のあるスパン形式

Splunk OpenTelemetry Collector を使用できない、またはバイパスする必要がある場合は、Splunk Observability Cloud の取り込み API エンドポイントにスパンデータを直接送信できます。

https://ingest.<realm>.signalfx.com/v2/trace のSplunk Observability Cloudの取り込みエンドポイントは、以下の形式でスパンを直接受信できます：

  • OTLP（ /v2/trace/otlp ）、Content-Type:application/x-protobuf で

  • Jaeger Thrift、Content-Type:application/x-thrift で

  • Zipkin v1、v2、Content-Type:application/json で

その他にも、以下のエンドポイントが利用可能です：

  • OTLP（ /v2/trace/otlp ）、Content-Type:application/x-protobuf で

  • Jaeger Thrift（ /v2/trace/jaegerthrift ）、Content-Type:application/x-thrift で

  • Zipkin v1、v2（ /v2/trace/signalfxv1 ）、Content-Type:application/json で

取り込み API エンドポイントの詳細については、「APM のトレースの送信」を参照してください。

注: また、gRPC エンドポイントを使用して直接、または、OpenTelemetry Collector から、OTLP 形式のトレースデータを Splunk Observability Cloud に送信できます。詳細については、「gRPC エンドポイントを使用して Splunk Observability Cloud にトレースを送信する」を参照してください。