Configurações gerais de SDK

OTEL_SERVICE_NAME

Define o valor do atributo de recurso service.name.

Valor padrão: unknown_service

Se service.name também for fornecido em OTEL_RESOURCE_ATTRIBUTES, então OTEL_SERVICE_NAME terá precedência.

Exemplo:

export OTEL_SERVICE_NAME="nome-do-seu-servico"

OTEL_RESOURCE_ATTRIBUTES

Pares de chave-valor que serão utilizados como atributos de recurso.

Valor padrão: vazio.

Exemplo:

export OTEL_RESOURCE_ATTRIBUTES="key1=value1,key2=value2"

Referências:

• Resource SDK
• Convenções Semânticas do Resource para convenções semânticas de tipos de recursos comuns

OTEL_TRACES_SAMPLER

Especifica o Sampler utilizado pelo SDK para realizar amostragem de rastros.

Valor padrão: parentbased_always_on

Exemplo:

export OTEL_TRACES_SAMPLER="traceidratio"

Os valores aceitos para OTEL_TRACES_SAMPLER são:

• always_on: AlwaysOnSampler
• always_off: AlwaysOffSampler
• traceidratio: TraceIdRatioBased
• parentbased_always_on: ParentBased(root=AlwaysOnSampler)
• parentbased_always_off: ParentBased(root=AlwaysOffSampler)
• parentbased_traceidratio: ParentBased(root=TraceIdRatioBased)
• parentbased_jaeger_remote: ParentBased(root=JaegerRemoteSampler)
• jaeger_remote: JaegerRemoteSampler
• xray: AWS X-Ray Centralized Sampling (terceiro)

OTEL_TRACES_SAMPLER_ARG

Especifica os argumentos, se aplicável, para o Sampler definido em OTEL_TRACES_SAMPLER. O valor especificado será utilizado apenas se OTEL_TRACES_SAMPLER for definido. Cada tipo de Sampler define sua própria entrada esperada, se houver. Entradas inválidas ou não reconhecidas são registradas como erro.

Valor padrão: vazio.

Exemplo:

export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.5"

Dependendo do valor definido em OTEL_TRACES_SAMPLER, a definição de OTEL_TRACES_SAMPLER_ARG pode ocorrer da seguinte maneira:

• Para os Samplers traceidratio e parentbased_traceidratio: Probabilidade de amostragem, um número no intervalo [0..1], por exemplo, “0.25”. Caso não seja definido, o valor padrão é 1.0.
• Para jaeger_remote e parentbased_jaeger_remote: O valor é uma lista separada por vírgulas:
  • Exemplo: endpoint=http://localhost:14250,pollingIntervalMs=5000,initialSamplingRate=0.25
  • endpoint: A rota em formato scheme://host:port do servidor gRPC que fornece a estratégia de amostragem para o serviço (sampling.proto).
  • pollingIntervalMs: em milissegundos, indicando com que frequência o Sampler consultará o backend para atualizações na estratégia de amostragem.
  • initialSamplingRate: no intervalo [0..1], utilizado como valor da probabilidade de amostragem caso não seja possível recuperar a estratégia de amostragem no backend. Este valor perde efeito assim que uma estratégia de amostragem é recuperada com sucesso, então a estratégia remota será utilizada até que uma nova atualização seja obtida com sucesso.

OTEL_PROPAGATORS

Especifica os Propagators a serem utilizados em uma lista separada por vírgulas.

Valor padrão: tracecontext,baggage

Exemplo:

export OTEL_PROPAGATORS="b3"

Os valores aceitos para OTEL_PROPAGATORS são:

• tracecontext: W3C Trace Context
• baggage: W3C Baggage
• b3: B3 Single
• b3multi: B3 Multi
• jaeger: Jaeger
• xray: AWS X-Ray (terceiro)
• ottrace: OT Trace (terceiro)
• none: Nenhum propagador configurado automaticamente.

OTEL_TRACES_EXPORTER

Especifica qual Exporter é utilizado para os rastros. Dependendo da implementação, pode ser uma lista separada por vírgulas.

Valor padrão: otlp

Exemplo:

export OTEL_TRACES_EXPORTER="jaeger"

Os valores aceitos são:

• otlp: OTLP
• jaeger: exportar no modelo de dados Jaeger
• zipkin: Zipkin
• console: Saída Padrão
• none: Nenhum exportador de rastros configurado automaticamente.

OTEL_METRICS_EXPORTER

Especifica qual Exporter é utilizado para as métricas. Dependendo da implementação, pode ser uma lista separada por vírgulas.

Valor padrão: otlp

Exemplo:

export OTEL_METRICS_EXPORTER="prometheus"

Os valores aceitos para OTEL_METRICS_EXPORTER são:

• otlp: OTLP
• prometheus: Prometheus
• console: Saída Padrão
• none: Nenhum exportador de métricas configurado automaticamente.

OTEL_LOGS_EXPORTER

Especifica qual Exporter é utilizado para os logs. Dependendo da implementação, pode ser uma lista separada por vírgulas.

Valor padrão: otlp

Exemplo:

export OTEL_LOGS_EXPORTER="otlp"

Os valores aceitos para OTEL_LOGS_EXPORTER são:

• otlp: OTLP
• console: Saída Padrão
• none: Nenhum exportador de logs configurado automaticamente.