O que é OpenTelemetry e como ajuda a encontrar erros entre serviços?

Publicado em 2026-10-20 por frfrand

OpenTelemetry explicado con ejemplos: traces, spans, métricas, contexto distribuido y límites de instrumentación.

OpenTelemetry é um projeto aberto que oferece APIs, SDK, ferramentas e convenções para produzir e transportar dados de telemetria, como traces, métricas e logs. Ajuda a observar aplicações sem amarrar toda a instrumentação a um único provedor.

Seu nome aparece muito quando um site se divide em vários serviços e descobrir onde ocorre uma falha começa a ser difícil.

Que problema resolve?

Imaginá que uma compra passa por uma API, um serviço de inventário, um de pagamentos e um banco de dados. Para o usuário tudo é um único botão. Para a equipe técnica são várias operações diferentes.

Se o pagamento demora seis segundos, precisas saber onde se perdeu esse tempo. OpenTelemetry permite instrumentar esses componentes de maneira consistente e relacionar informações entre eles.

Não identifica automaticamente a causa de cada erro: fornece mecanismos para reunir evidências.

O que é um span?

Um span representa uma operação com um início e um fim. Pode corresponder a uma requisição HTTP, uma consulta de banco de dados ou uma chamada entre serviços.

Vários spans relacionados formam um trace. O identificador de trace permite correlacionar partes de uma mesma operação, mesmo que cruzem diferentes processos.

Isso exige propagar corretamente o contexto. Se um serviço perder esses identificadores, parte do percurso pode aparecer desconectado.

Instrumentação automática e manual

Alguns frameworks e bibliotecas permitem instrumentação automática de operações comuns. Assim você pode obter traces de solicitações HTTP sem modificar cada função.

Mas para medir uma regra específica, como «validar disponibilidade de uma reserva», talvez faça sentido adicionar instrumentação manual. Um trace útil combina dados de infraestrutura com operações que têm significado para o negócio.

O que é o Collector?

O ecossistema inclui o OpenTelemetry Collector, um componente que pode receber, processar e exportar sinais de telemetria.

Pode ser útil para centralizar o envio de informações, aplicar transformações ou direcionar dados para uma plataforma de análise compatível. Mas é mais uma peça que precisa ser configurada, mantida e supervisionada.

Não confunda o Collector com uma interface de visualização completa: normalmente os dados são consultados em um backend ou ferramenta especializada.

O que acontece com os logs?

Os logs ajudam a explicar eventos. Sua relação com identificadores de trace facilita passar de «a API retornou um erro» para «esta operação específica falhou dentro deste serviço».

Nem todas as bibliotecas adicionam contexto automaticamente e as capacidades podem variar por linguagem e versão. É importante verificar qual instrumentação foi realmente implementada.

Custos, privacidade e amostragem

Guardar todos os rastros de um aplicativo muito concorrido pode consumir armazenamento e largura de banda. Existem estratégias de amostragem para conservar apenas uma parte, embora isso signifique que nem sempre você terá cada solicitação disponível.

Além disso, você não deve adicionar senhas, tokens nem dados pessoais completos como atributos de telemetria. Uma ferramenta de observação pode se tornar um risco se receber segredos desnecessários.

Um exemplo útil para diagnosticar uma falha

Após atualizar um aplicativo, a métrica de latência aumenta. Um rastreamento mostra que o backend leva pouco tempo para processar a solicitação, mas uma chamada externa utiliza quase todo o tempo.

Em vez de comprar um VPS mais potente por intuição, você pode revisar o provedor externo, seu tempo de resposta e a política de timeout.

Como isso se relaciona com o ArduMaker?

Se você hospeda vários serviços em VPS gerenciados pelo ArduMaker, pode instrumentá-los com OpenTelemetry se seus frameworks forem compatíveis e enviar os sinais para uma ferramenta de observação. O valor principal está em correlacionar o comportamento entre aplicativos, não em adicionar mais gráficos por decoração.

Em resumo: OpenTelemetry padroniza parte da produção e transporte de telemetria. É útil para investigar sistemas distribuídos, desde que você instrumente as operações corretas e proteja os dados coletados.

Fontes: Documentação do OpenTelemetry · Conceitos de traces · Collector.