Configurar los formatos de propagación del contexto de trazas - Managed Service for OpenTelemetry

Managed Service for OpenTelemetry es compatible con varios formatos de propagación del contexto de trazas, como W3C Trace Context, Zipkin B3 y Jaeger. Configure el propagador para mantener las trazas de extremo a extremo entre servicios que utilizan distintas bibliotecas de rastreo.

De forma predeterminada, Managed Service for OpenTelemetry utiliza tracecontext y baggage (los estándares de W3C). Si sus servicios emplean otros formatos, configure el propagador para que coincida con ellos.

Formatos compatibles

Formato	Encabezado HTTP	Descripción
`tracecontext`	`traceparent: {version}-{trace-id}-{parent-id}-{trace-flags}`	Estándar de W3C. Formato predeterminado. Consulte W3C Trace Context.
`baggage`	Definido por la especificación W3C Baggage	Estándar de W3C para propagar pares clave-valor. Formato predeterminado. Consulte W3C Baggage.
`b3`	`b3: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}`	Formato de encabezado único para sistemas basados en Zipkin. Consulte OpenZipkin B3.
`b3multi`	`X-B3-TraceId: {TraceId}X-B3-SpanId: {SpanId}X-B3-ParentSpanId: {ParentSpanId}X-B3-Sampled: {SamplingState}`	Formato de múltiples encabezados para sistemas basados en Zipkin. Consulte OpenZipkin B3.
`jaeger`	`uber-trace-id: {trace-id}:{span-id}:{parent-span-id}:{flags}`	Diseñado para servicios instrumentados con el cliente de Jaeger. Consulte Jaeger propagation format.
`xray`	Formato de AWS X-Ray	Recomendado cuando se integran servicios con AWS X-Ray.
`ottrace`	Formato de OpenTracing	Formato heredado para servicios instrumentados con OpenTracing.
`none`	Ningún encabezado inyectado ni extraído	Deshabilite por completo la propagación del contexto.

Configurar el formato de propagación

Especifique el formato de propagación mediante una propiedad del sistema de Java o una variable de entorno.

Usar una propiedad del sistema de Java

Agregue -Dotel.propagators a los argumentos de inicio de la JVM. Separe varios formatos con comas.

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

Marcador de posición	Descripción
`<your-service-name>`	Nombre que identifica al servicio en las trazas
`<your-token>`	Token de autenticación para el endpoint OTLP
`<your-endpoint>`	URL del endpoint del recolector OTLP
`<your-app>`	Nombre del archivo JAR de la aplicación

Usar una variable de entorno

Establezca la variable de entorno OTEL_PROPAGATORS antes de iniciar la aplicación. Separe varios formatos con comas.

export OTEL_PROPAGATORS="b3"

Después, inicie la aplicación como lo hace habitualmente.

Comportamiento con varios formatos

Cuando usted especifique varios formatos (por ejemplo, tracecontext,baggage,b3), el propagador inyecta y extrae encabezados en todos los formatos listados durante cada solicitud.

Tenga en cuenta a continuación:

Formatos predeterminados: tracecontext y baggage son estándares de W3C compatibles con la mayoría de las plataformas modernas de observability. Comience con estos, a menos que sus servicios requieran un formato distinto.
Compatibilidad con Zipkin: Utilice b3 (encabezado único) o b3multi (encabezados separados) para los sistemas de rastreo basados en Zipkin.
Compatibilidad con Jaeger: Emplee jaeger en los servicios instrumentados con el cliente de Jaeger.
Deshabilitar la propagación: Establezca el formato en none para dejar de inyectar y extraer los encabezados del contexto de trazas.