Configurações do Exporter OTLP

Configurações de rota

As seguintes variáveis de ambiente permitem configurar uma rota OTLP/gRPC ou OTLP/HTTP para seus rastros, métricas 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"

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"

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.

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"

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 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

Configurações de protocolo

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

OTEL_EXPORTER_OTLP_PROTOCOL

Especifica o protocolo de transporte OTLP a ser utilizado para todos os dados de telemetria.

Valor padrão: depende do SDK, porém, geralmente é http/protobuf ou grpc.

Exemplo: export OTEL_EXPORTER_OTLP_PROTOCOL=grpc

Os valores válidos são:

• grpc para utilizar OTLP/gRPC
• http/protobuf para utilizar OTLP/HTTP + protobuf
• http/json para utilizar OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

Especifica o protocolo de transporte OTLP a ser utilizado para dados de rastros.

Valor padrão: depende do SDK, porém, geralmente é http/protobuf ou grpc.

Exemplo: export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc

Os valores válidos são:

• grpc para utilizar OTLP/gRPC
• http/protobuf para utilizar OTLP/HTTP + protobuf
• http/json para utilizar OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

Especifica o protocolo de transporte OTLP a ser utilizado para dados de métricas.

Valor padrão: depende do SDK, porém, geralmente é http/protobuf ou grpc.

Exemplo: export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=grpc

Os valores válidos são:

• grpc para utilizar OTLP/gRPC
• http/protobuf para utilizar OTLP/HTTP + protobuf
• http/json para utilizar OTLP/HTTP + JSON

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

Especifica o protocolo de transporte OTLP a ser utilizado para dados de logs.

Valor padrão: depende do SDK, porém, geralmente é http/protobuf ou grpc.

Exemplo: export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc

Os valores válidos são:

• grpc para utilizar OTLP/gRPC
• http/protobuf para utilizar OTLP/HTTP + protobuf
• http/json para utilizar OTLP/HTTP + JSON