全部產品
Search
文件中心

Application Real-Time Monitoring Service:OpenTelemetry指定透傳Header格式

更新時間:Jul 06, 2024

OpenTelemetry支援tracecontext、baggage、b3、b3multi、jaeger等多種透傳格式,不同透傳格式會在HTTP請求中設定不同格式的Header。本文為您介紹如何設定OpenTelemetry的透傳格式。

OpenTelemetry支援的透傳格式

預設情況下,OpenTelemetry使用的是tracecontext和baggage。

透傳格式名稱

格式

備忘

tracecontext

traceparent : {version}-{trace-id}-{parent-id}-{trace-flags}

相關文檔

baggage

-

相關文檔

b3

b3: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}

相關文檔

b3multi

X-B3-TraceId: {TraceId}

X-B3-SpanId: {SpanId}

X-B3-ParentSpanId: {ParentSpanId}

X-B3-Sampled: {SamplingState}

相關文檔

jaeger

uber-trace-id : {trace-id}:{span-id}:{parent-span-id}:{flags}

相關文檔

xray

-

-

ottrace

-

-

none

-

-

設定透傳格式

在啟動應用時,有兩種方式可以設定OpenTelemetry TraceId的透傳格式:

  • 使用otel.propagators參數:-Dotel.propagators=tracecontext,baggage

    支援同時指定多種格式,使用英文半形逗號(,)分隔。

    -javaagent:/path/to/opentelemetry-javaagent.jar
     -Dotel.resource.attributes=service.name=<service-name>
     -Dotel.exporter.otlp.headers=Authentication=<token>
     -Dotel.exporter.otlp.endpoint=<endpoint>
     -Dotel.metrics.exporter=none
     -Dotel.propagators=tracecontext,baggage,b3
  • 設定OTEL_PROPAGATORS環境變數,然後運行程式。

    支援同時指定多種格式,使用英文半形逗號(,)分隔。

    export OTEL_PROPAGATORS="b3"