Ir para o conteúdo

Visualizador local de traces OpenTelemetry sem banco de dados

O projeto otel-g oferece uma maneira leve de visualizar traces coletados pelo OpenTelemetry diretamente na máquina do desenvolvedor, sem depender de um serviço de armazenamento externo. Isso é ideal para cenários onde a configuração de um backend como Jaeger, Tempo ou Zipkin seria excessiva ou indesejada.

Como funciona o otel-g

O otel-g captura os dados de telemetria enviados via protocolo OpenTelemetry (geralmente sobre gRPC ou HTTP) e os exibe em uma interface web local. Como não persiste os traces em um banco de dados, tudo fica na memória do processo, o que garante baixo consumo de recursos e início imediato.

Observacao

Como os traces não são armazenados de forma permanente, eles são perdidos quando o processo é encerrado. Essa característica torna a ferramenta adequada apenas para análise em tempo real.

Principais vantagens

  • Zero configuração de backend: não é preciso provisionar ou manter um serviço de armazenamento.
  • Baixo overhead: todo o processamento ocorre na memória da máquina local.
  • Integração simples: basta apontar o exportador do OpenTelemetry para o endpoint exposto pelo otel-g.

Dica

Use o otel-g em ambientes de desenvolvimento ou em pipelines de CI para validar a instrumentação antes de enviar os traces para um sistema de observabilidade de produção.

Exemplo de uso rápido

git clone https://github.com/metafab/otel-g.git
cd otel-g

# Construir e executar (presumindo que o projeto use Go)
go run ./cmd/otel-g
Após iniciar, configure seu aplicativo ou serviço para enviar traces para http://localhost:4317 (gRPC) ou http://localhost:4318 (HTTP/JSON), conforme a documentação do projeto.

Atencao

Verifique a versão do OpenTelemetry utilizada pelo seu SDK para garantir compatibilidade com o endpoint aceito pelo otel-g.

Pontos-chave

  • O otel-g é um visualizador local de traces OpenTelemetry que não requer banco de dados.
  • Ideal para desenvolvimento e testes rápidos, oferecendo baixo consumo de recursos.
  • Integra-se facilmente ao exportador padrão do OpenTelemetry via gRPC ou HTTP.
  • Os traces são mantidos apenas na memória e são perdidos ao encerrar o processo.
  • Disponível como código aberto no GitHub sob o usuário metafab.

Ferramentas e Tecnologias

  • [[OpenTelemetry]]
  • [[otel-g]]
  • [[GitHub]]

Nota pessoal

https://x.com/i/status/2055560604224557086

Tags

otel #tracing #observabilidade #local-viewer #sem-database