Repolode
newrelic

newrelic/go-agent

Go SDK для инструментирования приложений и отправки транзакций, ошибок и метрик среды выполнения в New Relic.

Open source альтернатива:Datadog APM

Звёзды
839
Форки
319
Открытые issues
61
Последний коммит
22 часа назад

Что это?

New Relic Go Agent — это библиотека для мониторинга Go-приложений. Она отслеживает транзакции, исходящие HTTP-запросы, обращения к базам данных и другие аспекты работы приложения, а также передаёт данные о среде выполнения: количество горутин, статистику сборки мусора, использование памяти и CPU. Go компилируется и не использует виртуальную машину, к которой можно подключиться для сбора данных, поэтому инструментирование добавляется вызовами API агента непосредственно в исходном коде.

Достаточно импортировать агент и создать приложение — это даст базовую видимость среды выполнения без дополнительных изменений. Для более подробного мониторинга в репозитории есть пакеты интеграции с распространёнными Go-фреймворками, например Gin, Fiber, Echo, gRPC и Gorilla Mux; драйверами баз данных, включая pgx, MySQL, MongoDB и клиентами Redis; библиотеками логирования, такими как zap, logrus и slog; а также AWS SDK и Lambda. Фреймворки без отдельного пакета интеграции всё равно можно инструментировать с помощью примитивов основного пакета newrelic.

Для работы агента требуется Go 1.22 или новее. Поддерживаются Linux, macOS и Windows. Лицензия — Apache 2.0.

Ключевые возможности

  • 01Отслеживает транзакции, исходящие запросы и обращения к базам данных в Go-приложениях.
  • 02Передаёт метрики среды выполнения: количество горутин, статистику сборки мусора, использование памяти и CPU.
  • 03Предоставляет пакеты интеграции с популярными веб-фреймворками, драйверами баз данных и библиотеками логирования.
  • 04Включает инструментирование AWS SDK и AWS Lambda.
  • 05Передаёт события AI Monitoring для вызовов OpenAI и AWS Bedrock.

Сценарии использования

  • Мониторинг производительности и ошибок веб-сервиса на Go, созданного с помощью Gin, Fiber или Echo.
  • Отслеживание задержек запросов к базе данных в Go-сервисе, использующем pgx или MySQL.
  • Добавление наблюдаемости в микросервисы на Go, взаимодействующие по gRPC.
  • Отправка логов 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 SDK для инструментирования приложений и отправки транзакций, ошибок и метрик среды выполнения в New Relic. New Relic Go Agent — это библиотека для мониторинга Go-приложений. Она отслеживает транзакции, исходящие HTTP-запросы, обращения к базам данных и другие аспекты работы приложения, а также передаёт данные о среде выполнения: количество горутин, статистику сборки мусора, использование памяти и CPU. Go компилируется и не использует виртуальную машину, к которой можно подключиться для сбора данных, поэтому инструментирование добавляется вызовами API агента непосредственно в исходном коде.
go-agent можно использовать бесплатно? Какая у него лицензия?
go-agent распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
go-agent всё ещё поддерживается?
Активно поддерживается. Последний коммит в go-agent — 6 нояб. 2026 г..
Для чего можно использовать go-agent?
Мониторинг производительности и ошибок веб-сервиса на Go, созданного с помощью Gin, Fiber или Echo. Отслеживание задержек запросов к базе данных в Go-сервисе, использующем pgx или MySQL. Добавление наблюдаемости в микросервисы на Go, взаимодействующие по gRPC. Отправка логов 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

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Инструмент компиляционной OpenTelemetry-инструментации для Go: добавляет трассировки и метрики через команду `otel go build`, не требуя менять код приложения.

907131GoApache-2.0Активно поддерживаетсяОбновлён 19 дней назад

Платформа наблюдаемости с открытым исходным кодом и нативной поддержкой OpenTelemetry: логи, метрики, трейсы, алерты и дашборды в одном решении для самостоятельного размещения.

32,5 тыс.+60 за неделю2,6 тыс.TypeScriptOtherОбновлён 19 часов назад