Repolode
Enviar
newrelic

newrelic/go-agent

SDK Go para instrumentar aplicações Go e enviar transações, erros e métricas de runtime ao New Relic.

Alternativa open source a:Datadog APM

Ver no GitHub
Estrelas
839
Forks
319
Issues abertas
61
Último commit
há 22 horas

O que é?

O New Relic Go Agent é uma biblioteca que adiciona monitoramento a aplicações Go. Ele rastreia transações, requisições HTTP de saída, chamadas a bancos de dados e outros aspectos do comportamento da aplicação, além de reportar dados de runtime, como quantidade de goroutines, estatísticas de garbage collection e uso de memória e CPU. Como Go é compilada e não tem uma máquina virtual na qual seja possível instalar hooks, a instrumentação é adicionada chamando a API do agente diretamente no código-fonte.

Basta importar o agente e criar uma aplicação para obter visibilidade básica do runtime, sem precisar fazer outras alterações. Para obter mais detalhes, o repositório oferece pacotes de integração para frameworks Go populares, como Gin, Fiber, Echo, gRPC e Gorilla Mux; drivers de banco de dados, incluindo pgx e MySQL; clientes MongoDB e Redis; bibliotecas de logging, como zap, logrus e slog; além de SDKs da AWS e do Lambda. Também é possível instrumentar frameworks sem um pacote dedicado usando as primitivas do pacote principal newrelic.

O agente requer Go 1.22 ou posterior e é compatível com Linux, macOS e Windows. É licenciado sob Apache 2.0.

Recursos principais

  • 01Rastreia transações, requisições de saída e chamadas a bancos de dados em aplicações Go.
  • 02Reporta métricas de runtime de goroutines, garbage collection, memória e CPU.
  • 03Oferece pacotes de integração para frameworks web, drivers de banco de dados e bibliotecas de logging populares.
  • 04Inclui instrumentação para AWS SDK e AWS Lambda.
  • 05Oferece eventos de AI Monitoring para chamadas ao OpenAI e ao AWS Bedrock.

Casos de uso

  • Monitorar o desempenho e os erros de um serviço web Go criado com Gin, Fiber ou Echo.
  • Rastrear a latência de consultas ao banco de dados em um serviço Go que usa pgx ou MySQL.
  • Adicionar observabilidade a microsserviços Go que se comunicam por gRPC.
  • Enviar logs de aplicações Go ao New Relic com contexto de trace.

Início rápido

  1. 1

    Instale o agente seguindo o guia GETTING_STARTED

  2. 2

    Execute o servidor de exemplo com sua chave de licença do New Relic

    env NEW_RELIC_LICENSE_KEY=__YOUR_NEW_RELIC_LICENSE_KEY__LICENSE__ go run v3/examples/server/main.go

Antes de usar

  • A versão mais recente requer Go 1.22 ou posterior.
  • A instrumentação deve ser adicionada manualmente por meio de chamadas à API do Go no código-fonte; ela não é adicionada automaticamente.

Em coleções

Plataformas de OpenTelemetry e observabilidade

Tópicos

#observability#monitoring#apm#golang#metrics#tracing

Perguntas frequentes

O que é go-agent?
SDK Go para instrumentar aplicações Go e enviar transações, erros e métricas de runtime ao New Relic. O New Relic Go Agent é uma biblioteca que adiciona monitoramento a aplicações Go. Ele rastreia transações, requisições HTTP de saída, chamadas a bancos de dados e outros aspectos do comportamento da aplicação, além de reportar dados de runtime, como quantidade de goroutines, estatísticas de garbage collection e uso de memória e CPU. Como Go é compilada e não tem uma máquina virtual na qual seja possível instalar hooks, a instrumentação é adicionada chamando a API do agente diretamente no código-fonte.
go-agent é gratuito? Qual é a licença?
go-agent é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
go-agent ainda é mantido?
Manutenção ativa. O último commit de go-agent foi em 6 de nov. de 2026.
Para que posso usar go-agent?
Monitorar o desempenho e os erros de um serviço web Go criado com Gin, Fiber ou Echo. Rastrear a latência de consultas ao banco de dados em um serviço Go que usa pgx ou MySQL. Adicionar observabilidade a microsserviços Go que se comunicam por gRPC. Enviar logs de aplicações Go ao New Relic com contexto de trace.
Como instalar go-agent?
Instale o agente seguindo o guia GETTING_STARTED Execute o servidor de exemplo com sua chave de licença do New Relic: env NEW_RELIC_LICENSE_KEY=__YOUR_NEW_RELIC_LICENSE_KEY__LICENSE__ go run v3/examples/server/main.go
Onde consigo go-agent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/newrelic/go-agent

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

Projetos relacionados