Configurações gerais de SDK
Nota
O suporte a variáveis de ambiente é opcional. Para informações detalhadas sobre quais variáveis de ambiente cada implementação de linguagem suporta, consulte a Matriz de Conformidade de Implementação.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
eparentbased_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
eparentbased_jaeger_remote
: O valor é uma lista separada por vírgulas:- Exemplo:
"endpoint=http://localhost:14250,pollingIntervalMs=5000,initialSamplingRate=0.25"
endpoint
: A rota em formatoscheme://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.
- Exemplo:
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.
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!