コンテキスト内のエージェント ログに移動

ほとんどのユーザーにとって、Go エージェントに組み込まれている自動ログ転送を使用するのが最善の解決策です。 セットアップが簡単で、ほとんどのユースケースに最適です。

このオプションを使用すると、ログにはspan.id 、 trace.id 、 hostname 、 entity.guid 、 entity.nameが含まれます。 これらのプロパティはログをスパン、トレース、その他のテレメトリーにリンクし、トラブルシューティングを容易にします。 ログ転送の制限について学習します。

自動アプリケーション ログ転送は、Go エージェント バージョン 3.20.0 でデフォルトで有効になりました。以上。アプリケーションでこれらのバージョンの Go エージェントを使用している場合、構成オプションを変更して自動ログ転送を有効にする必要はありません。

古いバージョンの Go エージェントを使用している場合は、構成を変更してアプリケーション ログの転送を有効にする必要があります。

app, err := newrelic.NewApplication(
  newrelic.ConfigAppLogForwardingEnabled(true),
)

よりカスタムなログ記録が必要なユーザー、または 60 秒サイクルあたり 10,000 件を超えるログ、または 5 秒サイクルあたり 833 件を超えるログを New Relic に送信する必要があるユーザーには、ログ転送を手動で設定することをお勧めします。 New Relic にログを送信するようにログフォワーダーを設定した後、Go エージェントの設定を変更してログを充実させます。 ログを強化するとは、ログフォワーダーが、span.id、trace.id、hostname、entity.guid、entity.name などのAPMコンテキスト データをログに追加することを意味します。

app, err := newrelic.NewApplication(
  newrelic.ConfigAppLogDecoratingEnabled(true),
)

Go エージェント バージョン v3.20.0 以降を使用している場合は、New Relic によって収集されたログの重複を避けるために、アプリケーション ログ転送を無効にする必要があります。

app, err := newrelic.NewApplication(
  newrelic.ConfigAppLogDecoratingEnabled(true),
  newrelic.ConfigAppLogForwardingEnabled(false),
)

logWriter ライブラリは、最新の New Relic Logs in Context 機能を go 標準ライブラリ ロガーに自動的に統合するio.Writerです。次の手順に従って、アプリケーションにインストールします。このライブラリでは、インストールされている Go エージェントのバージョンが 3.19.1 以降である必要があります。

1. モジュールに logWriter パッケージを追加します。

   bash

   コピー

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/logWriter

2. ロガーを初期化するファイルに logWriter パッケージをインポートします。

   import (
     "log"
   
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/logWriter"
   )

   コピー

3. logWriter オブジェクトを作成します。ログが書き込まれる有効な io.Writer と、初期化された go-agent アプリケーションを渡す必要があります。次の例では、標準出力に書き込みます。

   writer := logWriter.New(os.Stdout, newRelicApp)

   コピー

4. 新しい logWriter オブジェクトをロガーの出力先として、ロガー オブジェクトを作成します。

   logger := log.New(&writer, "", log.Default().Flags())

   コピー

   この時点で、作成されたロガーで書き込まれたログは、ログ構成設定に基づいて go-agent によって処理されます。

   トランザクション

   トランザクションのコンテキストをキャプチャする場合は、新しい logWriter オブジェクトと logger オブジェクトを作成する必要があります。トランザクション用の新しい logWriter オブジェクトを作成するには、トランザクションが関数に渡される方法に応じて、 WithTransaction()またはWithContext()関数を使用します。これらの関数は、トランザクション コンテキストを含む元の logWriter オブジェクトの新しいコピーを作成します。

   関数がトランザクションでラップされたコンテキストを受け取る場合は、WithContext() 関数を使用します。

   txnWriter := writer.WithContext(myWrappedContext)

   コピー

   関数がトランザクション ポインターを受け取る場合は、WithTransaction() 関数を使用します。

   txnWriter := writer.WithTransaction(myTransaction)

   コピー

   トランザクションごとに新しい logWriter を使用して、常に新しいロガーを作成するようにしてください。これにより、非同期プロセスが異なるコンテキスト情報を持つ同じロガー オブジェクトにアクセスする可能性がなくなります。

   txnLogger := log.New(txnWriter, "", log.Default().Flags())

   コピー

   トラブルシューティング

   logWriter ツールは、サイレント モードで失敗するように設計されています。デバッグ情報を有効にするには、logWriter オブジェクトでDebugLogging(true)メソッドを呼び出します。logWriter でエラーが発生すると、編集されていないログ行が常に最初の行に出力されます。DebugLogging が有効になっている場合、エラーが発生すると、次の行にエラー メッセージが出力されます。

   writer.DebugLogging(true)

   コピー

zerologWriter ライブラリは、最新の New Relic Logs in Context 機能を zerolog に自動的に統合するio.Writerです。次の手順に従って、アプリケーションにインストールします。このライブラリでは、インストールされている go-agent のバージョンが 3.19.1 以降である必要があります。

1. モジュールに zerologWriter パッケージを追加します。

   bash

   コピー

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/zerologWriter

2. zerolog ロガーを初期化するファイルに zerologWriter パッケージをインポートします。

   import (
     "log"
   
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/zerologWriter"
   )

   コピー

3. zerologWriter オブジェクトを作成します。ログが書き込まれる有効な io.Writer と、初期化された go-agent アプリケーションを渡す必要があります。次の例では、標準出力に書き込みます。

   writer := logWriter.New(os.Stdout, newRelicApp)

   コピー

4. ロガーの出力先として、新しい zerologWriter オブジェクトを使用してロガー オブジェクトを作成します。

   logger := zerolog.New(writer)

   コピー

   この時点で、作成されたロガーで書き込まれたログは、ログ構成設定に基づいて go-agent によって処理されます。

   トランザクション

   トランザクションのコンテキストをキャプチャする場合は、新しい zerologWriter オブジェクトと logger オブジェクトを作成する必要があります。トランザクション用の新しい zerologWriter オブジェクトを作成するには、トランザクションが関数に渡される方法に応じて、 WithTransaction()またはWithContext()関数を使用します。これらの関数は、トランザクション コンテキストを含む元の zerologWriter オブジェクトの新しいコピーを作成します。

   関数がトランザクションでラップされたコンテキストを受け取る場合は、WithContext() 関数を使用します。

   txnWriter := writer.WithContext(myWrappedContext)

   コピー

   関数がトランザクション ポインターを受け取る場合は、WithTransaction() 関数を使用します。

   txnWriter := writer.WithTransaction(myTransaction)

   コピー

   トランザクションごとに新しい zerologWriter を使用して常に新しいロガーを作成するようにしてください。これにより、非同期プロセスが異なるコンテキスト情報を持つ同じロガー オブジェクトにアクセスする可能性がなくなります。

   txnLogger := logger.Output(txnWriter)

   コピー

   トラブルシューティング

   zerologWriter ツールは、警告なしで失敗するように設計されています。デバッグ情報を有効にするには、zerologWriter オブジェクトでDebugLogging(true)メソッドを呼び出します。zerologWriter でエラーが発生すると、編集されていないログ行が常に最初の行に出力されます。DebugLogging が有効になっている場合、エラーが発生すると、次の行にエラー メッセージが出力されます。

   writer.DebugLogging(true)

   コピー

nrlogrus プラグインは、logrus ログ フレームワークを使用したコンテキスト取り込みでの自動ログを有効にします。アプリケーションがそれを使用するように設定されると、Go エージェントは logrus に書き込まれたログを自動的に取り込みます。これには、Go エージェントのバージョン 3.18.0 以降が必要です。

1. nrlogrus パッケージをモジュールに追加します。

   bash

   コピー

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrlogrus

   2. logrus ロガーを初期化するファイルに nrlogrus パッケージをインポートします。

   import (
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrlogrus"
   
     "github.com/sirupsen/logrus"
   )

   コピー

2. 新しい nrlogrus フォーマッタを構成して作成します。有効なアプリケーションと有効な logrus フォーマッターを渡す必要があります。渡されたフォーマッタによって、書き込まれるログの外観が決まります。

   nrlogrusFormatter := nrlogrus.NewFormatter(newRelicApplication, &logrus.TextFormatter{})

   コピー

3. ロガーのフォーマッターを新しく作成した nrlogrus フォーマッターに設定します。

   log := logrus.New()
   log.SetFormatter(nrlogrusFormatter)

   コピー

   この時点で、作成されたロガーで書き込まれたログは、ログ構成設定に基づいて go-agent によって処理されます。

   トランザクション

   トランザクション内でログを計測する場合、そのトランザクションをコンテキストとして logrus に渡す必要があります。これにより、そのトランザクションの新しいロガー オブジェクトが作成され、エージェントによって処理されたログが発生したトランザクションとスパンにリンクされます。

   トランザクションを含むコンテキストがある場合:

   txnLogger := log.WithContext(yourWrappedContext)

   コピー

   それ以外の場合は、コンテキストを作成して logrus に渡すことができます。

   txnLogger := log.WithContext(newrelic.NewContext(context.Background(), txn))

   コピー

nrzap プラグインは、Zap ログ フレームワークを使用したコンテキスト取り込みでの自動ログを有効にします。アプリケーションがそれを使用するように設定されると、go-agent は Zap に書き込まれたログを自動的に取り込みます。これには、インストールされている go-agent のバージョンが 3.22.1 以降である必要があります。

1. nrzap パッケージをモジュールに追加します。

   bash

   コピー

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrzap

2. Zap ロガーを初期化するファイルに nrzap パッケージをインポートします。

   import (
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrzap"
   
     "go.uber.org/zap"
     "go.uber.org/zap/zapcore"
   )

   コピー

3. アプリケーションのログ記録用に新しい Zap コア オブジェクトを構成して作成します。コア オブジェクトは変更する必要がなく、ラップするだけでよいため、このオブジェクトへのポインタを使用可能な状態にしておくことをお勧めします。これにより、ラップされた Zap コアをより効率的に作成するためにそれを再利用できるようになります。

   core := zapcore.NewCore(zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()), zapcore.AddSync(os.Stdout), zap.InfoLevel)

   コピー

4. Zap コア オブジェクトをラップしてログをキャプチャし、New Relic に送信します。ラップ関数に有効な Zap コアが渡されている限り、たとえエラーが返されたとしても、返されるコアは有効であることに注意してください。 このため、エラーの種類を確認することが重要です。

   backgroundCore, err := nrzap.WrapBackgroundCore(core, app)
   if err != nil && err != nrzap.ErrNilApp {
     panic(err)
   }
   
   backgroundLogger := zap.New(backgroundCore)

   コピー

   トランザクション

   トランザクション内でログを計測する場合は、新しい Zap コアとロガーを作成する必要があります。これは、 WrapTransactionCore() 関数を呼び出すことで実行できます。

   txn := app.StartTransaction("nrzap example transaction")
   txnCore, err := nrzap.WrapTransactionCore(core, txn)
   if err != nil && err != nrzap.ErrNilTxn {
       panic(err)
   }
   
   txnLogger := zap.New(txnCore)

   コピー

nrslog プラグインは、標準ライブラリ slog フレームワークを使用したコンテキスト取り込みでの自動ログを有効にします。 アプリケーションがそれを使用するように設定されると、ラップされた slog ロガーで書き込まれたすべてのログが Go エージェントによって自動的に取り込まれます。 これには、Go エージェントのバージョン 3.30.0 以降が必要です。

1. nrslog パッケージをモジュールに追加します。

   bash

   コピー

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrslog

2. slog ロガーを初期化するファイルに nrslog パッケージをインポートします。

   import (
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrslog"
   
     "log/slog"
   )

   コピー

3. 新しい nrslog ハンドラーを構成して作成します。 有効な New Relilc アプリケーション ポインタ、io.Writer、および slog.HandlerOptions オブジェクトへのポインタを渡す必要があります。 便利な関数が nrslog にパッケージ化されており、slog でそのまま提供されるテキストおよび json ハンドラーを自動的にインストルメントします。 この例では、 slog.TextHandlerをラップします。

   instrumentedTextHandler := nrslog.TextHandler(app, os.Stdout, &slog.HandlerOptions{})

   コピー

4. インストゥルメント化されたハンドラーを使用して新しいロガーを作成します。

   logger := slog.New(instrumentedTextHandler)

   コピー

   この時点で、この新しいロガーで書き込まれたログは、ログ構成設定に基づいて go-Agent によって処理されます。

   トランザクション

   ログが トランザクション 内でインストゥルメントされた場合、その トランザクション をnrslogに渡す必要があります。 これを行うための推奨される方法は、コンテキスト内で slog に渡すことです。 トランザクションを含むコンテキストがある場合:

   txnCtx := newrelic.NewContext(context.Background(), txn)
   logger.InfoContext(txnCtx, "My log message")

   コピー