Configurações do Exporter OTLP

Nota

Support for environment-variable configuration varies across languages. For the list of variables supported by each language, see the environment variable compliance matrix.

Configurações de rota

As seguintes variáveis de ambiente permitem configurar uma rota OTLP/gRPC ou OTLP/HTTP para seus rastros, métricas, perfis e logs.

`OTEL_EXPORTER_OTLP_ENDPOINT`

A URL da rota base para qualquer tipo de sinal, com um número de porta especificado opcionalmente. Pode ser útil quando você está enviando mais de um sinal para a mesma rota e deseja que uma variável de ambiente controle este valor.

Valor padrão:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318"

Exemplo:

gRPC: export OTEL_EXPORTER_OTLP_ENDPOINT="https://my-api-endpoint:443"
HTTP: export OTEL_EXPORTER_OTLP_ENDPOINT="http://my-api-endpoint/"

Para OTLP/HTTP, os Exporters no SDK constroem URLs específicos de sinal quando esta variável de ambiente é definida. Isso significa que se você estiver enviando rastros, métricas e logs, as seguintes URLs são construídos a partir do exemplo acima:

Rastros: "http://my-api-endpoint/v1/traces"
Métricas: "http://my-api-endpoint/v1/metrics"
Logs: "http://my-api-endpoint/v1/logs"

Para OTLP/gRPC, os valores de rota são alvos gRPC. Não adicione caminhos de sinal do OTLP/HTTP, como /v1/traces, /v1/metrics ou /v1/logs, aos valores de rota gRPC; os Exporters gRPC utilizam o método de serviço protobuf do OTLP correspondente a cada sinal após se conectarem ao alvo configurado.

`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`

URL da rota apenas para dados de rastros, com um número de porta especificado opcionalmente. Normalmente termina com v1/traces ao utilizar OTLP/HTTP.

Valor padrão:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318/v1/traces"

Exemplo:

gRPC: export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://my-api-endpoint:443"
HTTP: export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="http://my-api-endpoint/v1/traces"

`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`

URL da rota apenas para dados de métricas, com um número de porta especificado opcionalmente. Normalmente termina com v1/metrics ao utilizar OTLP/HTTP.

Valor padrão:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318/v1/metrics"

Exemplo:

gRPC: export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://my-api-endpoint:443"
HTTP: export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://my-api-endpoint/v1/metrics"

`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`

URL da rota apenas para dados de logs, com um número de porta especificado opcionalmente. Normalmente termina com v1/logs ao utilizar OTLP/HTTP.

Valor padrão:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318/v1/logs"

Exemplo:

gRPC: export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://my-api-endpoint:443"
HTTP: export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="http://my-api-endpoint/v1/logs"

`OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT`

URL da rota apenas para dados de perfis, com um número de porta especificado opcionalmente. Normalmente termina com v1/profiles ao utilizar OTLP/HTTP.

Valor padrão:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318/v1/profiles"

Exemplo:

gRPC: export OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT="https://my-api-endpoint:443"
HTTP: export OTEL_EXPORTER_OTLP_PROFILES_ENDPOINT="http://my-api-endpoint/v1/profiles"

Configurações de cabeçalhos

As seguintes variáveis de ambiente permitem configurar cabeçalhos adicionais como uma lista de pares chave-valor para adicionar em solicitações gRPC ou HTTP.

Os cabeçalhos são representados em um formato correspondente ao W3C Baggage, por exemplo key1=value1,key2=value2. Metadados delimitados por ponto e vírgula não são suportados. Para mais detalhes, consulte Especificando cabeçalhos via variáveis de ambiente na especificação do protocolo.

`OTEL_EXPORTER_OTLP_HEADERS`

Uma lista de cabeçalhos para aplicar a todos os dados de saída (rastros, métricas e logs).

Valor padrão: N/A

Exemplo: export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"

`OTEL_EXPORTER_OTLP_TRACES_HEADERS`

Uma lista de cabeçalhos para aplicar a todos os dados de rastros de saída.

Valor padrão: N/A

Exemplo: export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"

`OTEL_EXPORTER_OTLP_METRICS_HEADERS`

Uma lista de cabeçalhos para aplicar a todos os dados de métricas de saída.

Valor padrão: N/A

Exemplo: export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"

`OTEL_EXPORTER_OTLP_LOGS_HEADERS`

Uma lista de cabeçalhos para aplicar a todos os dados de logs de saída.

Valor padrão: N/A

Exemplo: export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"

`OTEL_EXPORTER_OTLP_PROFILES_HEADERS`

Uma lista de cabeçalhos para aplicar a todos os dados de perfis de saída.

Valor padrão: N/A

Exemplo: export OTEL_EXPORTER_OTLP_PROFILES_HEADERS="api-key=key,other-config-value=value"

Configurações de tempo limite

As seguintes variáveis de ambiente configuram o tempo máximo (em milissegundos) que um Exporter OTLP aguardará antes de transmitir o próximo lote de dados.

`OTEL_EXPORTER_OTLP_TIMEOUT`

O valor de tempo limite para todos os dados de saída (rastros, métricas e logs) em milissegundos.

Valor padrão: 10000 (10s)

Exemplo: export OTEL_EXPORTER_OTLP_TIMEOUT=500

`OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`

O tempo limite para todos os rastros de saída em milissegundos.

Valor padrão: 10000 (10s)

Exemplo: export OTEL_EXPORTER_OTLP_TRACES_TIMEOUT=500

`OTEL_EXPORTER_OTLP_METRICS_TIMEOUT`

O tempo limite para todas as métricas de saída em milissegundos.

Valor padrão: 10000 (10s)

Exemplo: export OTEL_EXPORTER_OTLP_METRICS_TIMEOUT=500

`OTEL_EXPORTER_OTLP_LOGS_TIMEOUT`

O tempo limite para todos os logs de saída em milissegundos.

Valor padrão: 10000 (10s)

Exemplo: export OTEL_EXPORTER_OTLP_LOGS_TIMEOUT=500

`OTEL_EXPORTER_OTLP_PROFILES_TIMEOUT`

O tempo limite para todos os dados de perfis de saída em milissegundos.

Valor padrão: 10000 (10s)

Exemplo: export OTEL_EXPORTER_OTLP_PROFILES_TIMEOUT=500

Configurações de protocolo

As seguintes variáveis de ambiente configuram o protocolo de transporte OTLP que um Exporter OTLP utiliza.