Repolode
제출하기
newrelic

newrelic/go-agent

Go 애플리케이션을 계측하고 트랜잭션, 오류, 런타임 메트릭을 New Relic으로 전송하는 Go SDK입니다.

대체할 수 있는 제품:Datadog APM

GitHub에서 보기
스타
839
포크
319
열린 이슈
61
마지막 커밋
21시간 전

어떤 프로젝트인가요?

New Relic Go Agent는 Go 애플리케이션에 모니터링 기능을 추가하는 라이브러리입니다. 트랜잭션, 외부 HTTP 요청, 데이터베이스 호출 등 애플리케이션 동작을 추적하고, 고루틴 수, 가비지 컬렉션 통계, 메모리 및 CPU 사용량과 같은 런타임 데이터를 보고합니다. Go는 컴파일 언어이며 연결할 가상 머신이 없으므로, 소스 코드에서 에이전트 API를 호출해 계측을 추가합니다.

에이전트를 가져오고 애플리케이션을 생성하는 것만으로도 추가 변경 없이 기본적인 런타임 가시성을 확보할 수 있습니다. 더 세부적인 정보를 얻을 수 있도록 저장소에는 Gin, Fiber, Echo, gRPC, Gorilla Mux 같은 일반적인 Go 웹 프레임워크, pgx, MySQL, MongoDB, Redis 클라이언트 등의 데이터베이스 드라이버, zap, logrus, slog 같은 로깅 라이브러리, AWS SDK 및 Lambda용 통합 패키지가 제공됩니다. 전용 패키지가 없는 프레임워크도 핵심 newrelic 패키지의 기본 기능을 사용해 계측할 수 있습니다.

에이전트는 Go 1.22 이상이 필요하며 Linux, macOS, Windows를 지원합니다. Apache 2.0 라이선스로 배포됩니다.

핵심 기능

  • 01Go 애플리케이션의 트랜잭션, 외부 요청, 데이터베이스 호출을 추적합니다.
  • 02고루틴, 가비지 컬렉션, 메모리, CPU 런타임 메트릭을 보고합니다.
  • 03널리 쓰이는 웹 프레임워크, 데이터베이스 드라이버, 로거용 통합 패키지를 제공합니다.
  • 04AWS SDK 및 AWS Lambda 계측 기능을 포함합니다.
  • 05OpenAI 및 AWS Bedrock 호출에 대한 AI Monitoring 이벤트를 제공합니다.

활용 사례

  • Gin, Fiber, Echo로 구축한 Go 웹 서비스의 성능과 오류를 모니터링합니다.
  • 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를 호출해 직접 추가해야 합니다.

포함된 컬렉션

OpenTelemetry 및 옵저버빌리티 플랫폼

토픽

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

자주 묻는 질문

go-agent은(는) 무엇인가요?
Go 애플리케이션을 계측하고 트랜잭션, 오류, 런타임 메트릭을 New Relic으로 전송하는 Go SDK입니다. New Relic Go Agent는 Go 애플리케이션에 모니터링 기능을 추가하는 라이브러리입니다. 트랜잭션, 외부 HTTP 요청, 데이터베이스 호출 등 애플리케이션 동작을 추적하고, 고루틴 수, 가비지 컬렉션 통계, 메모리 및 CPU 사용량과 같은 런타임 데이터를 보고합니다. Go는 컴파일 언어이며 연결할 가상 머신이 없으므로, 소스 코드에서 에이전트 API를 호출해 계측을 추가합니다.
go-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
go-agent은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
go-agent은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. go-agent의 마지막 커밋은 2026년 11월 6일입니다.
go-agent은(는) 어디에 사용할 수 있나요?
Gin, Fiber, Echo로 구축한 Go 웹 서비스의 성능과 오류를 모니터링합니다. 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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트