Configure trace context propagation formats - Managed Service for OpenTelemetry

Managed Service for OpenTelemetry, W3C Trace Context, Zipkin B3 ve Jaeger dahil olmak üzere birden fazla iz bağlamı yayılma biçimini destekler. Farklı izleme kitaplıkları kullanan hizmetler arasında uçtan uca izleri korumak için yayıcıyı yapılandırın.

Varsayılan olarak Managed Service for OpenTelemetry, tracecontext ve baggage (W3C standartları) kullanır. Hizmetleriniz başka biçimler kullanıyorsa yayıcıyı buna göre yapılandırın.

Desteklenen biçimler

Biçim	HTTP üst bilgisi	Açıklama
`tracecontext`	`traceparent: {version}-{trace-id}-{parent-id}-{trace-flags}`	W3C standardı. Varsayılan biçim. Bakınız: W3C Trace Context.
`baggage`	W3C Baggage belirtimi tarafından tanımlanır	Anahtar-değer çiftlerinin yayılması için W3C standardı. Varsayılan biçim. Bakınız: W3C Baggage.
`b3`	`b3: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}`	Zipkin tabanlı sistemler için tek üst bilgi biçimi. Bakınız: OpenZipkin B3.
`b3multi`	`X-B3-TraceId: {TraceId}X-B3-SpanId: {SpanId}X-B3-ParentSpanId: {ParentSpanId}X-B3-Sampled: {SamplingState}`	Zipkin tabanlı sistemler için çoklu üst bilgi biçimi. Bakınız: OpenZipkin B3.
`jaeger`	`uber-trace-id: {trace-id}:{span-id}:{parent-span-id}:{flags}`	Jaeger istemcisi ile instrument edilmiş hizmetler için. Bakınız: Jaeger propagation format.
`xray`	AWS X-Ray biçimi	AWS X-Ray ile entegre edilen hizmetler için.
`ottrace`	OpenTracing biçimi	OpenTracing ile instrument edilmiş hizmetler için eski biçim.
`none`	Üst bilgi eklenmez veya çıkarılmaz	Bağlam yayılımını tamamen devre dışı bırakır.

Yayılma biçimini yapılandırın

Yayılma biçimini bir Java sistem özelliği veya ortam değişkeni kullanarak belirtebilirsiniz.

Java sistem özelliği kullanın

JVM başlatma bağımsız değişkenlerine -Dotel.propagators ekleyin. Birden fazla biçimi virgülle ayırın.

java -javaagent:/path/to/opentelemetry-javaagent.jar \
     -Dotel.resource.attributes=service.name=<your-service-name> \
     -Dotel.exporter.otlp.headers=Authentication=<your-token> \
     -Dotel.exporter.otlp.endpoint=<your-endpoint> \
     -Dotel.metrics.exporter=none \
     -Dotel.propagators=tracecontext,baggage,b3 \
     -jar <your-app>.jar

Yer tutucu	Açıklama
`<your-service-name>`	İzlerde hizmeti tanımlayan ad
`<your-token>`	OTLP uç noktası için kimlik doğrulama belirteci
`<your-endpoint>`	OTLP toplayıcı uç nokta URL'si
`<your-app>`	Uygulama JAR dosya adı

Ortam değişkeni kullanın

Uygulamayı başlatmadan önce OTEL_PROPAGATORS ortam değişkenini ayarlayın. Birden fazla biçimi virgülle ayırın.

export OTEL_PROPAGATORS="b3"

Ardından uygulamayı her zamanki gibi başlatın.

Birden fazla biçimle davranış

Birden fazla biçim belirttiğinizde (örneğin, tracecontext,baggage,b3), yayıcı her istekte listelenen tüm biçimlerdeki üst bilgileri ekler ve çıkarır.

Şu noktaları göz önünde bulundurun:

Varsayılan biçimler: tracecontext ve baggage çoğu modern gözlemlenebilirlik platformu tarafından desteklenen W3C standartlarıdır. Hizmetleriniz farklı bir biçim gerektirmedikçe bunlarla başlayın.
Zipkin uyumluluğu: Zipkin tabanlı izleme sistemleri için b3 (tek üst bilgi) veya b3multi (ayrı üst bilgiler) kullanın.
Jaeger uyumluluğu: Jaeger istemcisi ile instrument edilmiş hizmetler için jaeger kullanın.
Yayılımı devre dışı bırakma: İz bağlamı üst bilgilerini eklemeyi ve çıkarmayı durdurmak için biçimi none olarak ayarlayın.