コンテキスト内の .NET エージェント ログ

あなたが好きなログフォワーダーをすでに持っていますか？私たちはあなたをカバーしています！言語エージェントは、自動ログインコンテキスト機能へのアクセスを提供するために必要なリンクメタデータでログを装飾できます。

このオプションは、エージェント内転送では使用しないでください。エージェント内転送が有効になっているときに 外部ログフォワーダー を使用してログをNewRelicに送信すると、ログがNewRelicに2回送信されます。アカウントによっては、二重請求が発生する場合があります。

1. このオプションを使用する場合は、エージェント内転送構成オプションが無効になっていることを確認してください。

2. 構成でログの装飾を有効にしてから、エージェントを再起動してログの装飾を開始します。

   <applicationLogging enabled="true">
     <forwarding enabled="false" />
     <localDecorating enabled="true" />
   </applicationLogging>

   コピー

   環境変数：

   NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=false
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

   コピー

   重要

   環境変数の値が存在する場合は、構成ファイルの値よりも優先されます。

   デコレータは、すべてのログ message (プレーン テキスト) に 5 つの属性を追加します: entity.guid 、 entity.name 、 hostname 、 trace.id 、および span.id 。例：

   This is my log message. NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}

   コピー

   重要

   JSON の場合、 NR-LINKING データは message プロパティに存在する必要があります。

   ログメッセージが空または空白の場合、出力メッセージも空になります。 例：

   NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|.

   コピー

   出力されるログメッセージは空の文字列になります。

   ログがトランザクションの外部で発生した場合、またはアプリケーションのコンテキストに適用できない場合、一部の属性は空になる可能性があります。装飾フォーマッターを使用するには、手動プロセスよりもこのオプションをお勧めします。

   重要

   キー名にハイフンを使用できないロギング フレームワークをサポートするため、ロギング フレームワークから NR-LINKING トークンを読み出すために使用されるキーは、 NR_LINKING ではなく NR-LINKING です。

   log4net構成

   log4net の場合、.NET エージェントは、 NR-LINKING トークンをログ イベント オブジェクトの NR_LINKING というプロパティとして保存します。次の一般的なレイアウトの例は、 NR-LINKING トークンを書き出すように log4net を構成する方法を示しています。他のレイアウトもサポートされていますが、以下にリストされていません。SimpleLayout は変更できないためサポートされていません。

   PatternLayout / DynamicPatternLayout : conversionPattern を更新して、行末に NR_LINKING プロパティを含めます。

   <layout type="log4net.Layout.PatternLayout">
     <conversionPattern value="%date %5level %logger.%method [%line] - MESSAGE: %message %property{NR_LINKING}%newline %exception" />
   </layout>

   コピー

   log4net.Ext.Json : レイアウトを更新して、メッセージ JSON プロパティに NR_LINKING というメンバーを含めます。

   log4net.Appender.AdoNetAppender : このアペンダーは他のレイアウトとは少し異なる設定になっています。 メタデータを含めるには、 message を更新する必要があります。 次の例では、 PatternLayout を使用してこれを示しています。

   <parameter>
     <parameterName value="@message" />
     <dbType value="String" />
     <size value="4000" />
     <layout type="log4net.Layout.PatternLayout">
       <conversionPattern value="%message %property{NR_LINKING}" />
     </layout>
   </parameter>

   コピー

   セリログ構成

   Serilog の場合、.NET エージェントは、 NR-LINKING トークンをログ イベント オブジェクトの NR_LINKING というプロパティとして保存します。次の一般的なフォーマッタとシンクの例は、 NR-LINKING トークンを書き出すように Serilog を構成する方法を示しています。他のシンクとフォーマッタもサポートされていますが、以下にリストされていません。

   Plain text using an outputTemplate : outputTemplate を更新して、行末に NR_LINKING プロパティを含めます。

   Log.Logger = new LoggerConfiguration()
       .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
       .Enrich.FromLogContext()
       .WriteTo.File(
           path: @"plaintext_log.txt",
           fileSizeLimitBytes: 1_000_000,
           rollOnFileSizeLimit: true,
           shared: true,
           flushToDiskInterval
   
   
   
   
       
   : TimeSpan.FromSeconds(1),
           outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {NR_LINKING} {NewLine}{Exception}"
       )
       .CreateLogger();

   コピー

   JSON Formatter with automatic property output : デフォルトの JsonFormatter は、 NR_LINKING メタデータをメッセージ プロパティに書き込まず、代わりに各プロパティを独自の JSON オブジェクトに書き込みます。 コンテキスト内のログが機能する前に、 NR_LINKING データを message プロパティの末尾に書き込むカスタム JSON フォーマッタを作成する必要があります。

   Microsoft.Extensions.Logging構成

   Microsoft.Extensions.Logging の場合、.NET エージェントは、メッセージを含む NR-LINKING トークンを新しく作成されたスコープに保存します。Microsoft.Extensions.Logging は出力のために他のフレームワークに依存しているため、詳細については上記の log4net または Serilog 構成を参照してください。

   NLog構成

   NLog の場合、.NET エージェントは、メッセージの末尾に直接 NR-LINKING トークンを自動的に追加できるため、追加の構成は必要ありません。

言語エージェントがログを転送および装飾できるようになる前は、アプリケーションを更新してリンクメタデータを送信することにより、コンテキスト内でログを有効にすることができました。

このオプションは引き続きサポートされていますが、おすすめしません。このアプローチを使用する手順について は、コンテキストオプションの手動ログを 参照してください。

また、この方法では、コンテキストでログを有効にする前に、ログフォワーダーをインストールする必要があります。ログフォワーダーがない場合は、NewRelicUIで インフラストラクチャエージェント を使用するように求められます。

既存のログ転送ソリューションを使用し、後でエージェントを更新してコンテキスト内の自動ログを使用することにした場合は、必ず disable your manual log forwarder を実行してください。 そうしないと、アプリは二重のログ行を送信することになります。 アカウントによっては、二重請求が発生する可能性があります。 詳細については、 特定のログフォワーダー を無効にする手順に従ってください。