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からデフォルトでオンになっています。

オプションの調整：

これを有効にすると、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

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

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

このオプションは、エージェント内転送では使用しないでください。エージェント内転送が有効になっているときに外部ログフォワーダーを使用してログを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}|

   コピー

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

   手動装飾フォーマッター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にログデータが表示されない場合は、トラブルシューティング手順に従ってください。