Repolode
newrelic

newrelic/go-agent

Goアプリケーションを計装し、トランザクション、エラー、ランタイムメトリクスをNew Relicに送信するGo SDK。

代替できる製品:Datadog APM

スター
839
フォーク
319
未解決の Issue
61
最終コミット
21 時間前

これは何?

New Relic Go Agentは、Goアプリケーションにモニタリング機能を追加するライブラリです。トランザクション、外部へのHTTPリクエスト、データベース呼び出しなど、アプリケーションの動作を追跡し、goroutine数、ガベージコレクションの統計情報、メモリとCPUの使用量といったランタイムデータを報告します。Goはコンパイル言語で、フック可能な仮想マシンがないため、ソースコードからAgentのAPIを呼び出して計装します。

Agentをimportしてアプリケーションを作成するだけで、追加の変更を加えずに基本的なランタイムの状況を把握できます。より詳細な情報を得るために、リポジトリにはGin、Fiber、Echo、gRPC、Gorilla Muxなどの一般的なGo製Webフレームワーク、pgx、MySQL、MongoDB、Redisクライアントなどのデータベースドライバー、zap、logrus、slogなどのロギングライブラリ、AWS SDKやLambda向けのインテグレーションパッケージが用意されています。専用パッケージのないフレームワークも、コアのnewrelicパッケージが提供するプリミティブを使って計装できます。

このAgentにはGo 1.22以降が必要で、Linux、macOS、Windowsに対応しています。ライセンスはApache 2.0です。

主な機能

  • 01Goアプリケーションのトランザクション、外部へのリクエスト、データベース呼び出しを追跡します。
  • 02goroutine、ガベージコレクション、メモリ、CPUのランタイムメトリクスを報告します。
  • 03主要なWebフレームワーク、データベースドライバー、ロガー向けのインテグレーションパッケージを提供します。
  • 04AWS SDKとAWS Lambdaの計装機能を備えています。
  • 05OpenAIとAWS Bedrockの呼び出しに関するAI Monitoringイベントを提供します。

ユースケース

  • 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に送信するGo 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト