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

これは最も単純なアプローチであり、ログフォワーダーの設定にアクセスしたり関心を持ったりしていない開発者や、アプリのコンテキストでログやその他のリンクメタデータの機能を確認したいアカウントに最適です。多くのオーバーヘッド。

このオプションを使用して、エージェントはspan.id 、 trace.id 、 hostname 、 entity.guid 、およびentity.nameを追加します。ログ転送の制限について学習します。

必要なのは、ログ転送機能を備えたエージェント バージョン ( Python エージェント 7.12.0.176 以降) をインストールすることだけです。転送が無効になっている場合は、次の構成を使用できます。

newrelic.ini：

application_logging.enabled=true
application_logging.forwarding.enabled=true

環境変数：

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

このオプションは、エージェント バージョン 7.16.0.178からデフォルトでオンになっています。

Optional adjustments:

これを有効にすると、1分ごとにNewRelicに送信されるログの最大数も制御できます。デフォルト値は10,000です。 60秒のウィンドウで10,000を超えるログが受信されると、ログのサンプリングが開始されます。

より多くのログを受信するには、より大きな数値に設定します。受け取るログの数を減らすには、数値を小さく設定します。 100,000までの整数が有効です。

newrelic.ini：

event_harvest_config.harvest_limits.log_event_data=10000

環境変数：

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000

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

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

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

このオプションは、手動のログ装飾フォーマッタでも使用しないでください。コードベースに手動フォーマッターへの参照がある場合は、このオプションを有効にする前にそれらを削除してください。

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

   newrelic.ini：

   application_logging.forwarding.enabled=false

   コピー

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

   newrelic.ini：

   application_logging.enabled=true
   application_logging.forwarding.enabled=false
   application_logging.local_decorating.enabled=true

   コピー

   環境変数：

   NEW_RELIC_APPLICATION_LOGGING_ENABLED: "true"
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED: "false"
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED: "true"

   コピー

   デコレータは、すべてのログメッセージに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}|

   コピー

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

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

   コピー

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

   ログがトランザクションの外部で発生した場合、またはアプリケーションのコンテキストに適用できない場合、一部の属性は空になる可能性があります。

   手動装飾フォーマッターNewRelicContextFormatterよりもこのオプションをお勧めします。

また、手動インストレーション オプションを使用して、Python によるAPMアプリ モニターのコンテキストでのログ記録を有効にすることもできます。

1. NewRelicでのロギングをすでに設定していることを確認してください。これには、アプリケーションログを収集し、NewRelicに転送されるメタデータを拡張するサポートされているログフォワーダーの構成が含まれます。

2. をインストールするか、 を最新の Python エージェントバージョンに更新し、 分散型トレーシングを有効にする. Python agent version 5.4.0 or higher を使用して、コンテキスト内のログを取得します。

3. ログハンドラーのコンテキストでログを構成します。言語エージェントがログを転送および装飾できるようになる前は、ログフォーマッターをインスタンス化してログハンドラーに追加することで、コンテキスト内でログを有効にすることができました。この例では、デフォルトでログをsys.stderrに書き込むStreamHandlerを使用していますが、任意のハンドラーを使用できます。ログハンドラーの構成の詳細については、 Python.orgのドキュメントを参照してください。

   # Import the logging module and the New Relic log formatter
   import logging
   from newrelic.agent import NewRelicContextFormatter
   
   # Instantiate a new log handler
   handler = logging.StreamHandler()
   
   # Instantiate the log formatter and add it to the log handler
   formatter = NewRelicContextFormatter()
   handler.setFormatter(formatter)
   
   # Get the root logger and add the handler to it
   root_logger = logging.getLogger()
   root_logger.addHandler(handler)

   コピー

4. ログアペンダーが正しく構成されていることを確認するには、アプリケーションを実行してから、クエリ演算子has:span.id has:trace.idを使用してNewRelicのログデータを確認します。

   すべてが正しく構成され、データが強化されたメタデータとともにNew Relicに転送されている場合、ログはJSONとして出力され、 trace.id フィールドとspan.idフィールドが含まれているはずです。 UIにログデータが表示されない場合は、トラブルシューティング手順に従ってください。