Repolode
Enviar
alibaba

alibaba/loongsuite-go

Ferramenta de instrumentação OpenTelemetry em tempo de compilação para Go que adiciona traces e métricas com o prefixo `otel go build`, sem alterar o código da aplicação.

Ver no GitHubSite
Estrelas
907
Forks
131
Issues abertas
31
Último commit
há 19 dias

O que é?

O LoongSuite Go Agent é uma ferramenta que adiciona observabilidade OpenTelemetry a aplicações Go em tempo de compilação. Em vez de editar o código-fonte, você compila o projeto com o prefixo `otel` (por exemplo, `otel go build`), e a ferramenta injeta instrumentação em bibliotecas compatíveis durante a compilação.

A ferramenta oferece suporte a várias bibliotecas Go bastante usadas, incluindo net/http, gin, gorm, go-redis, grpc, clientes Kafka e diversos SDKs de LLM, como openai-go e anthropic-sdk-go. O projeto também oferece uma forma de injetar código personalizado em bibliotecas sem suporte oficial e inclui exemplos de logging com zap, detecção de injeção SQL e monitoramento de consumidores Kafka.

Há binários pré-compilados para Linux, macOS e Windows, além de um script de instalação para shell. Tanto a ferramenta quanto a aplicação instrumentada exigem Go 1.25 ou posterior. O projeto foi contribuído para a comunidade OpenTelemetry e está em incubação como opentelemetry-go-compile-instrumentation.

Recursos principais

  • 01Adiciona instrumentação em tempo de compilação por meio do comando `otel go build`, sem alterações no código-fonte.
  • 02Oferece suporte a uma ampla variedade de bibliotecas Go, incluindo frameworks HTTP, ORMs, clientes Redis, gRPC e filas de mensagens.
  • 03Inclui instrumentação para vários SDKs de LLM, como openai-go e langchaingo.
  • 04Permite injetar código personalizado em bibliotecas sem suporte oficial.
  • 05Oferece binários pré-compilados para Linux, macOS e Windows.

Casos de uso

  • Adicionar tracing distribuído a um serviço Go existente sem mexer no código.
  • Monitorar chamadas HTTP, ao banco de dados e ao Redis em um microsserviço Go.
  • Observar chamadas a APIs de LLM feitas por aplicações Go.
  • Medir o overhead da instrumentação antes de implantá-la.

Início rápido

  1. 1

    Baixe um binário pré-compilado do otel para sua plataforma na página de releases

  2. 2

    Ou compile e instale a ferramenta a partir do código-fonte

    make install
  3. 3

    Verifique se a ferramenta está instalada

    otel version
  4. 4

    Compile seu projeto com o prefixo otel

    otel go build

Antes de usar

  • Tanto a ferramenta quanto a aplicação instrumentada exigem Go 1.25 ou posterior.
  • Se go build funcionar, mas otel go build falhar, o README considera que provavelmente se trata de um bug.

Em coleções

Plataformas de OpenTelemetry e observabilidade

Tópicos

#opentelemetry#observability#tracing#golang#instrumentation#apm#metrics#go

Perguntas frequentes

O que é loongsuite-go?
Ferramenta de instrumentação OpenTelemetry em tempo de compilação para Go que adiciona traces e métricas com o prefixo `otel go build`, sem alterar o código da aplicação. O LoongSuite Go Agent é uma ferramenta que adiciona observabilidade OpenTelemetry a aplicações Go em tempo de compilação. Em vez de editar o código-fonte, você compila o projeto com o prefixo `otel` (por exemplo, `otel go build`), e a ferramenta injeta instrumentação em bibliotecas compatíveis durante a compilação.
loongsuite-go é gratuito? Qual é a licença?
loongsuite-go é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
loongsuite-go ainda é mantido?
Manutenção ativa. O último commit de loongsuite-go foi em 19 de out. de 2026.
Para que posso usar loongsuite-go?
Adicionar tracing distribuído a um serviço Go existente sem mexer no código. Monitorar chamadas HTTP, ao banco de dados e ao Redis em um microsserviço Go. Observar chamadas a APIs de LLM feitas por aplicações Go. Medir o overhead da instrumentação antes de implantá-la.
Como instalar loongsuite-go?
Baixe um binário pré-compilado do otel para sua plataforma na página de releases Ou compile e instale a ferramenta a partir do código-fonte: make install Verifique se a ferramenta está instalada: otel version Compile seu projeto com o prefixo otel: otel go build
Onde consigo loongsuite-go?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alibaba/loongsuite-go

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados