newrelic/go-agent

这是什么？

核心功能

• 01追踪 Go 应用中的事务、外发请求和数据库调用。
• 02上报 goroutine、垃圾回收、内存和 CPU 等运行时指标。
• 03提供 Web 框架、数据库驱动和日志库的集成包。
• 04支持 AWS SDK 和 AWS Lambda 的埋点。
• 05支持为 OpenAI 和 AWS Bedrock 调用发送 AI 监控事件。

适用场景

• 监控基于 Gin、Fiber 或 Echo 构建的 Go Web 服务的性能与错误。
• 追踪使用 pgx 或 MySQL 的 Go 服务中的数据库查询耗时。
• 为通过 gRPC 通信的 Go 微服务增加可观测性。
• 将带有链路上下文的 Go 应用日志发送到 New Relic。

快速上手

1. 1

   按照 GETTING_STARTED 指南安装该代理

2. 2

   使用你的 New Relic 许可证密钥运行示例服务器

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

使用前须知

• !最新版本需要 Go 1.22 或更高版本。
• !需要通过在源代码中手动调用 Go API 添加监控,而不是自动完成。

收录于专题

标签

常见问题

go-agent 是什么？

用于为 Go 应用接入 New Relic 监控，上报事务、错误和运行时指标的 SDK。 New Relic Go Agent 是一个为 Go 应用添加监控能力的库。它可以追踪事务、外发 HTTP 请求、数据库调用等应用行为，并上报 goroutine 数量、垃圾回收统计以及内存和 CPU 使用情况等运行时数据。由于 Go 是编译型语言、没有虚拟机可以挂钩，接入方式是在源代码中调用 agent 的 API。

go-agent 可以免费使用吗？用的什么许可证？

go-agent 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

go-agent 还在维护吗？

活跃维护中。go-agent 最近一次提交是在 2026年11月6日。

go-agent 适合用来做什么？

监控基于 Gin、Fiber 或 Echo 构建的 Go Web 服务的性能与错误。 追踪使用 pgx 或 MySQL 的 Go 服务中的数据库查询耗时。 为通过 gRPC 通信的 Go 微服务增加可观测性。 将带有链路上下文的 Go 应用日志发送到 New Relic。

go-agent 怎么安装和运行？

按照 GETTING_STARTED 指南安装该代理 使用你的 New Relic 许可证密钥运行示例服务器: env NEW_RELIC_LICENSE_KEY=__YOUR_NEW_RELIC_LICENSE_KEY__LICENSE__ go run v3/examples/server/main.go

在哪里获取 go-agent？

源代码和安装说明在 GitHub 上：https://github.com/newrelic/go-agent