Configure trace context propagation formats - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

O Managed Service for OpenTelemetry oferece suporte a diversos formatos de propagação de contexto de rastreamento, como W3C Trace Context, Zipkin B3 e Jaeger. Configure o propagador para manter rastreamentos de ponta a ponta entre serviços que usam bibliotecas de rastreamento diferentes.

Por padrão, o Managed Service for OpenTelemetry usa tracecontext e baggage (padrões W3C). Se seus serviços usarem outros formatos, configure o propagador adequadamente.

Formatos suportados

Formato	Cabeçalho HTTP	Descrição
`tracecontext`	`traceparent: {version}-{trace-id}-{parent-id}-{trace-flags}`	Padrão W3C. Formato padrão. Consulte W3C Trace Context.
`baggage`	Definido pela especificação W3C Baggage	Padrão W3C para propagação de pares chave-valor. Formato padrão. Consulte W3C Baggage.
`b3`	`b3: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}`	Formato de cabeçalho único para sistemas baseados em Zipkin. Consulte OpenZipkin B3.
`b3multi`	`X-B3-TraceId: {TraceId}X-B3-SpanId: {SpanId}X-B3-ParentSpanId: {ParentSpanId}X-B3-Sampled: {SamplingState}`	Formato de múltiplos cabeçalhos para sistemas baseados em Zipkin. Consulte OpenZipkin B3.
`jaeger`	`uber-trace-id: {trace-id}:{span-id}:{parent-span-id}:{flags}`	Para serviços instrumentados com o cliente Jaeger. Consulte Jaeger propagation format.
`xray`	Formato AWS X-Ray	Para serviços integrados ao AWS X-Ray.
`ottrace`	Formato OpenTracing	Formato legado para serviços instrumentados com OpenTracing.
`none`	Nenhum cabeçalho injetado ou extraído	Desativa totalmente a propagação de contexto.

Configure o formato de propagação

Especifique o formato de propagação usando uma propriedade de sistema Java ou uma variável de ambiente.

Usar uma propriedade de sistema Java

Adicione -Dotel.propagators aos argumentos de inicialização da JVM. Separe vários formatos com vírgulas.

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

Espaço reservado	Descrição
`<your-service-name>`	Nome que identifica o serviço nos rastreamentos
`<your-token>`	Token de autenticação do endpoint OTLP
`<your-endpoint>`	URL do endpoint do coletor OTLP
`<your-app>`	Nome do arquivo JAR da aplicação

Usar uma variável de ambiente

Defina a variável de ambiente OTEL_PROPAGATORS antes de iniciar a aplicação. Separe vários formatos com vírgulas.

export OTEL_PROPAGATORS="b3"

Em seguida, inicie a aplicação normalmente.

Comportamento com múltiplos formatos

Ao especificar vários formatos (por exemplo, tracecontext,baggage,b3), o propagador injeta e extrai cabeçalhos em todos os formatos listados a cada requisição.

Observe os seguintes pontos:

Formatos padrão: tracecontext e baggage são padrões W3C compatíveis com a maioria das plataformas modernas de observabilidade. Use-os inicialmente, a menos que seus serviços exijam um formato diferente.
Compatibilidade com Zipkin: Use b3 (cabeçalho único) ou b3multi (cabeçalhos separados) para sistemas de rastreamento baseados em Zipkin.
Compatibilidade com Jaeger: Use jaeger para serviços instrumentados com o cliente Jaeger.
Desativar propagação: Defina o formato como none para interromper a injeção e a extração de cabeçalhos de contexto de rastreamento.