Digite para filtrar os verbetes do Glossário.

    DevOps e infraestrutura · Formação DevOps

    O que é OTLP?

    O OTLP padroniza o envio de traces, métricas e logs. Aplicações e coletores precisam combinar o transporte, a codificação e o endereço do sinal exportado.

    Também chamado de: OpenTelemetry Protocol

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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:

    Terminal
    export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
    export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/v1/traces

    A 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

    Aplicaçã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
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano