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="your-service-name"

OTEL_RESOURCE_ATTRIBUTES

Pares de chave-valor que serão utilizados como atributos de recurso. Consulte a página de Recurso do SDK para mais detalhes.

Valor padrão: Vazio.

Consulte a página convenção semântica de Recursos para obter informações sobre as convenções semânticas a serem seguidas para tipos de recursos comuns.

Exemplo:

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

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:

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:

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.

Last modified January 31, 2025: [CI] Fix fix:dict and run it (#6143) (0d38602e)