O protocolo entre a aplicação e o receptor
O OTLP (OpenTelemetry Protocol) é o protocolo usado para transmitir telemetria, como traces, métricas e logs, entre aplicações, coletores e serviços de destino. Ele define a estrutura das mensagens, sua codificação e as respostas do receptor. Um trace reúne registros do percurso de uma execução, como uma chamada que atravessa vários serviços.
A especificação do OTLP prevê transmissão por gRPC ou por HTTP. No OTLP/HTTP, o exportador envia mensagens por POST com codificação binária Protobuf ou JSON conforme o formato definido pelo protocolo. Um servidor que recebe qualquer JSON por HTTP não é, por esse motivo, um receptor OTLP.
Endereço específico para traces
Este exemplo de configuração usa um exportador compatível com as variáveis do OpenTelemetry e um coletor local com receptor OTLP/HTTP ativo:
export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobufexport OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/v1/tracesA primeira variável seleciona HTTP com Protobuf binário. A segunda informa o endereço completo para traces, incluindo /v1/traces. Como ela é específica desse sinal, o caminho precisa estar preenchido. Ao iniciar a aplicação com essas variáveis, um exportador que as suporte usará essa configuração.
Os comandos apenas definem variáveis no shell e não enviam telemetria. Você ainda precisa de instrumentação que produza registros e de um exportador habilitado. Em outro host ou container, localhost aponta para o próprio ambiente da aplicação, portanto o endereço deve corresponder ao local do coletor.
Uma resposta de sucesso do coletor confirma a aceitação nessa etapa. Para conferir a chegada ao destino final, acompanhe também a exportação feita pelo coletor e procure o trace no serviço de consulta.
Dúvidas frequentes
Perguntas frequentes sobre OTLP
- Qual é a diferença entre as portas 4317 e 4318?
- São as portas padrão de OTLP/gRPC e OTLP/HTTP, respectivamente. O receptor pode usar outras portas, por isso você precisa conferir o transporte configurado nos dois lados.
- Um HTTP 200 significa que todos os registros foram aceitos?
- A resposta OTLP pode indicar sucesso parcial com registros recusados. Você precisa examinar o corpo da resposta e os campos de rejeição do sinal enviado.
- O OTLP também armazena a telemetria?
- O protocolo define a transmissão. A retenção e a consulta pertencem ao serviço de destino. A confirmação de um coletor intermediário se refere à comunicação com ele.
Para continuar
Recursos relacionados
Documentação
OpenTelemetry: codificação e entrega por OTLP
Especifica os transportes, as respostas de sucesso e as condições de rejeição parcial na transmissão de telemetria.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar uma exportação sem registros no destino e revisar a configuração do coletor.
Abrir recursoAplicação na formação
Formação DevOps
A configuração da telemetria exige acompanhar o envio da aplicação ao coletor e o encaminhamento até o serviço de consulta.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.