Pythonエージェントの設定

通常は、エージェントのホストシステム上のローカル設定ファイルからPythonエージェントを構成します。起動時に設定ファイルへのパスを指定するには、以下のいずれかの方法を使用します。

• newrelic.agent.initialize()を呼び出す際、1つ目の引数として設定ファイルへのパスを指定します。

  または

• 環境変数NEW_RELIC_CONFIG_FILEを設定します。newrelic-adminラッパースクリプトを使用する場合は、ラッパースクリプトがエージェントを自動的に呼び出すため、環境変数を使用する必要があります。

  エージェントは2種類の設定ファイルをサポートします。エージェントv10.2.0以前では.ini構文を使用する必要がありますが、Pythonバージョン3.11以降で実行されるエージェントv10.3.0以降では.tomlファイルにも対応します。

  「.ini」設定ファイル形式

  設定ファイルは、Microsoft Windowsの.iniファイルと同様の構造を使用します。詳細については、PythonのConfigParserモジュールのファイル形式に関するドキュメントを参照してください。

  基本的な構造は以下のようになるはずです。

  [newrelic]
  license_key = <license key>
  app_name = Python Application

  コピー

  「.toml」設定ファイル形式

  ヒント

  Python 3.11以降では、設定用の新しい.toml構文が標準ライブラリに追加されました。この新しい形式には、エージェントバージョン10.3.0で対応しました。

  設定ファイルは、TomのObvious Minimal Language.tomlファイルを使用します。詳細については、ファイル形式に関する公式ドキュメントを参照してください。

  .toml構文を使用するには、構文タイプを示すために、設定ファイルの名前の末尾に.tomlを付ける必要があります。標準のpyproject.tomlは他のライブラリの設定と併用できますが、newrelic.tomlのような専用のファイルを使用することもできます。

  基本的な構造は以下のようになるはずです。

  [tool.newrelic]
  license_key = <license key>
  app_name = Python Application

  コピー

  ヒント

  Pythonエージェントには、newrelic/newrelic.iniというサンプル設定ファイルが含まれています。このファイルは、newrelic-adminスクリプトからgenerate-configコマンドで生成することや、ダウンロードリポジトリからダウンロードすることができます。

サーバーサイドコンフィグレーションを使用すると、New Relic UIで一部の設定を行うことができます。これにより、複数のホストで実行されているエージェントでも、変更内容がすべてのエージェントに自動的に適用されます。利用可能な場合、このドキュメントでは、設定オプションごとに、サーバー側設定のUIラベルをServer-side labelとして記載しています。

環境変数を使用すると、特定の主要設定のデフォルト値を上書きできます。同等の設定がエージェント設定ファイルに明示的に記載されている場合、環境変数よりも設定ファイルの設定が優先されます。利用可能な環境変数は、設定オプションごとにEnviron variableとして記載されています。

シンプルな構成の場合、環境変数をサーバーサイドコンフィグレーションと併用することで、エージェント設定ファイルを完全に省略できます。これはHerokuのデフォルト設定であり、New Relicアドオンをインストールすると必要な環境変数が自動的に設定されます。

New Relic CodeStreamを使用してIDEからパフォーマンスを監視する場合は、リポジトリをサービスに関連付け、ビルドSHAまたはリリースタグをエラーに関連付ける必要があります。

特定のWSGIサーバーでは、リクエストごとにアプリケーション名とキャプチャ属性の設定を上書きできます。これは、リクエストごとのWSGI環境辞書に渡される追加のキーと値のペアを定義できるWSGIサーバーで可能です。

これらの値を文字列（on、off、true、false、1、0）で設定します。Pythonコードを使用して実装された設定メカニズムから設定された場合、TrueまたはFalseと評価されるPythonオブジェクトも使用できます。

一部のエージェント設定を上書きできるほか、WSGI環境キーを使用してリクエストごとの設定を行うこともできます。

New Relicアカウントのライセンスキーを指定します。このキーは、アプリのメトリクスをNew Relicアカウントに関連付けます。

New Relic UIでのデータ集約に使用するアプリケーション名。複数のアプリケーションに対して同時にデータを報告するには、各アプリケーション名をセミコロン;で区切って指定します。セミコロンの前にスペースを入れないでください。スペースを入れると、Pythonの設定パーサーが名前を埋め込みコメントとして解釈します。

trueの場合、エージェントはアプリケーションのパフォーマンスデータを収集し、このデータをデータコレクターに報告します。

trueの場合、エージェントはWebアプリを計装しますが、実際のデータは送信しません。このオフラインモードでは、アクティブなエージェントに対する料金は発生しません。

開発者モードを使用して、エージェントの新しいバージョンをテストするか、開発者環境でサードパーティ製パッケージに対してエージェントをテストしてください。オフラインモードは、エージェントの収集するメトリクスがどこにも報告されないため、APMをローカルで実行する方法ではありません。

エージェントに関するイシューのデバッグに役立つログファイルの名前を設定します。これは、エージェントがWebアプリケーションプロセスの親ユーザーやそのプロセスが書き込み権限を持つディレクトリを知らないため、デフォルトでは設定されていません。詳細については、Pythonのロギングを参照してください。

これを設定する場合は、必ず、格納ディレクトリとファイルに対する権限が適切であること、およびWebアプリケーションが実行されるユーザーに当該ファイルへの書き込み権限があることを確認してください。

ログファイルの場所を設定している場合、ログメッセージの詳細レベルを設定します。このlog_levelはPythonのloggingモジュールのログレベルには影響しません。設定可能な値は、詳細度の低い順に、critical、error、warning、info、debugです。

エージェントのイシューを報告するには、debug設定が最も便利です。ただし、debugは非常に短時間で大量の情報を生成するため、問題を再現するのに必要な時間以上にエージェントをこのレベルにしないでください。

高セキュリティモードでは、特定のセキュリティ設定が強制的に適用され、その設定の上書きが防止されるため、機密データがNew Relicに送信されることはありません。高セキュリティモードを有効にすると、リクエストパラメーターは収集されず、生のSQLを送信することはできません。

高セキュリティモードを有効にするには、ローカルの.ini設定ファイルでtrueに設定し、Account settingsページから有効にします。詳細については、高セキュリティを参照してください。

デフォルトでは、Pythonエージェントはサーバーに直接接続しようとします。ホストとNew Relicのコレクターの間にファイアウォールがあり、HTTPプロキシの使用が必要な場合は、proxy_hostとproxy_portにHTTPプロキシ用の必要な値を設定してください。HTTPプロキシによってプロキシ認証が実装されている場合は、proxy_userとproxy_passも設定してください。

proxy_scheme設定は、HTTPプロキシとの通信に使用されるプロトコル方式を指定します。httpに設定すると、エージェントはHTTPプロキシを介したSSLトンネルを使用してエンドツーエンド暗号化を行います。

proxy_scheme、proxy_host、proxy_port設定を使用する代わりに、proxy_host設定にプロキシの有効なURIを設定することもできます。スキーム、ホスト、ポートを含めます（例：http://proxy-host:8000）。HTTPプロキシの詳細を環境変数NEW_RELIC_PROXY_HOSTで設定した場合も、同様に機能します。

監査ログファイルの名前を設定します。設定すると、エージェントは監視対象プロセスとコレクターの間でやり取りされるメッセージの詳細をログに記録します。これにより、Pythonエージェントのセキュリティを評価できます。

起動時にアプリの作業ディレクトリがどこになるか確信が持てない限り、絶対パスを使用してください。これを設定する場合は、必ず、格納先のディレクトリとファイルに対するアクセス権限が適切であることを確認してください。また、Webアプリケーションの親ユーザーがそのファイルに書き込みできる権限を持っていることを確認してください。

タグを追加します。コロン:で区切って名前:値を指定し、タグを追加する場合はセミコロン;で区切ります。

labels = Server:One;Data Center:Primary

APM UIに表示される. ホスト名を設定します。設定すると、エージェントが自動的に取得するデフォルトのホスト名が上書きされます。

api_keyをnewrelic-admin record-deployで使用するように設定します。

ローカルCAバンドルへのパスを手動で上書きします。このCAバンドルは、New Relicのデータ収集サービスが提示するSSL証明書を検証するために使用されます。

この閾値を超えた場合に、トランザクショントレースを記録します。秒数（小数点可）で指定します。

apdex_tについては、New Relicの用語集の項目を参照してください。

この設定を使用して、すべての属性をオンまたはオフにできます。

属性が有効になっている場合、このリストにある属性キーがNew Relicに送信されます。リスト内の各キーは、以下のようにスペースで区切る必要があります。

key1 key2 key3

属性に関するルールは、エージェントの属性に関するページに記載されています。

このリストにあるすべての属性キーは、New Relicに送信されません。リスト内の各キーは、以下のようにスペースで区切る必要があります。

key1 key2 key3

属性に関するルールは、エージェントの属性に関するページに記載されています。

trueに設定すると、AIモニタリングが有効化されます。

falseに設定すると、ストリーミングされた大規模言語モデル（LLM）データの概要とメッセージイベントを記録する計装が無効になります。

falseに設定すると、エージェントはLLMイベントでキャプチャされた入力および出力コンテンツ（プロンプトやレスポンスのテキスト文字列など）を省略します。これは、LLMとの間で送受信される機密データを記録したくない場合のオプションのセキュリティ設定です。

有効にすると、トランザクショントレーサーは低速なトランザクションに関する詳細情報をキャプチャします。

トランザクショントレースを収集するタイミングの閾値（秒）。コントローラーのアクションのレスポンスタイムがこの閾値を超えると、エージェントはトランザクショントレースを記録します。有効な値は、正のフロートまたはapdex_f（apdex_tの4倍）です。

トランザクショントレーサーが有効になっている場合、エージェントはSQLステートメントを記録できます。レコーダーには3つのモードがあります：off（SQLを送信しない）、raw（SQLステートメントを元のまま送信する）、obfuscated（数値と文字列リテラルを取り除く）。

ほとんどのWebフレームワーク（Djangoを含む）ではSQLクエリがパラメータ化されるため、実際のクエリには値が埋め込まれていません。これらのフレームワークのいずれかでrawモードを使用すると、Pythonエージェントは値を埋め込む前のSQLのみを参照します。パラメータ化されたSQLはobfuscatedモードとよく似たものになります。

SQL呼び出しからスタックトレースを収集するタイミングの閾値（秒）。SQLステートメントがこの閾値を超えると、エージェントが現在のスタックトレースを取得します。これは、アプリケーション内で長時間のSQL呼び出しが発生している箇所を特定するのに役立ちます。

Pythonエージェントが遅いSQLクエリの実行計画をキャプチャするかどうかを指定します。MySQLとPostgreSQLでのみサポートされています。

トランザクショントレースのクエリがこの閾値を超える場合、スロークエリデータと利用可能な実行計画が報告されます。transaction_tracer.explain_enabledがfalseの場合、実行計画の収集は行われません。

この設定を使用して、トランザクショントレースのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、この設定（transaction_tracer.attributes.enabled）がどのように設定されているかにかかわらず、属性はトランザクショントレースに送信されません。

属性がトランザクショントレースについて有効になっている場合、このリストにあるすべての属性キーが、トランザクショントレースでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれる属性キーはすべて、トランザクショントレースには送信されません。詳しくはエージェント属性ルールを参照してください。

指定した関数またはメソッドについて、エージェントは関数の実行時間に関する追加の計測情報を取得します。これらの名前はmodule:functionまたはmodule:class.functionの形式で指定してください。

関数名やクラス名でワイルドカード（グロビング）を指定するには、fnmatchモジュールでサポートされているパターンを使用できます。モジュールパスではワイルドカードは指定できません。パターンはmodule:function*またはmodule:class.*の形式で指定してください。

例えば、以下のファイル内のすべての検証関数に関数トレースを追加したい場合：

def validate_credentials():
…
def validate_status():
…
def format_message():
…

エージェント設定ファイルに次の行を追加し、ワイルドカードを使用してmy-app/common/utils.py内のすべての検証関数に関数トレースを追加します。

[newrelic]
...
transaction_tracer.function_trace = common.utils:validate*

この設定を使用すると、トランザクショントレースの各セグメントのすべての属性を有効または無効にできます。ルートレベルでattributes.enabledがfalseである場合は、この設定（transaction_segments.attributes.enabled）がどのように設定されているかにかかわらず、属性はトランザクショントレースのセグメントに送信されません。

属性がトランザクショントレースのセグメントについて有効になっている場合、このリストにあるすべての属性キーが、トランザクショントレースのセグメントでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれるすべての属性キーは、トランザクショントレースのセグメントには含まれません。詳しくはエージェント属性ルールを参照してください。

有効にすると、エラーコレクターは捕捉されなかった例外に関する情報を収集します。

特定のエラーの収集を停止するには、無視するPython例外タイプの名前をスペース区切りで列挙します。例外名はmodule:classの形式で指定します。

エージェントがエラーとして記録せず、無視すべきHTTPステータスコードを列挙します。ステータスコードを追加する場合は、整数をスペースで区切ります。範囲を指定する場合は、開始値と終了値の間にハイフン-を挿入します。デフォルトコードのいずれかを「許可」リストに追加するには、コードの前に感嘆符!を付けます。

一部のフレームワークは例外を使用してHTTPレスポンスを返さないため、この設定は一部のWebフレームワークでのみ有効です。

指定された例外クラスが、エラーをAPMにレポートする間にエラー率やApdexスコアに影響を与えないようにします。想定されるPython例外タイプの名前を、スペース区切りで指定します。例外名はmodule:classの形式で指定します。

エラーをAPMにレポートする間に、指定したHTTPステータスコードがエラー率やApdexスコアに影響を与えないようにします。ステータスコードは整数をスペースで区切って指定します。範囲を指定する場合は、開始値と終了値の間にハイフン-を挿入します。リスト内のコードのいずれかを無効にするには、コードの前に感嘆符!を付けます。

一部のフレームワークは例外を使用してHTTPレスポンスを返さないため、この設定は一部のWebフレームワークでのみ有効です。

PythonエージェントのインスタンスによってNew Relicに送信される1分あたりのエラーイベントの制限。

この設定を使用して、トレース対象のエラーのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseの場合、この設定（error_collector.attributes.enabled）がどのように設定されているかにかかわらず、トレースされたエラーに属性は送信されません。

トレース対象のエラーで属性が有効になっている場合、このリストに含まれるすべての属性キーがトレース対象のエラーに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれる属性キーは、トレース対象のエラーには送信されません。詳しくはエージェント属性ルールを参照してください。

有効にすると、エラーコレクターは高度な分析のためにイベントデータを収集します。詳細については、APM エラーを参照してください。

ブラウザ監視を有効にします。詳細については、Pythonにおけるページ読み込みのタイミングを参照してください。

サポートされているPython Webフレームワークの場合、この設定により、ブラウザ監視用のJavaScriptフラグメントの自動挿入が有効になります。

ブラウザ監視エージェントが自動計装するHTML Content-Typeを指定します。項目を追加するには、スペース区切りで並べてください。

browser_monitoring.content_type = text/html application/xhtml+xml

この設定を使用すると、ブラウザ監視のすべての属性を有効または無効にすることができます。これはページビューイベントに送信されるデータです。ルートレベルでattributes.enabledがfalseの場合、この設定（browser_monitoring.attributes.enabled）がどのように設定されているかにかかわらず、ブラウザ監視で属性は送信されません。

browser_monitoringで属性が有効になっている場合、このリストに含まれるすべての属性キーがページビューで送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれる属性キーはすべて、ページビューには送信されません。詳しくはエージェント属性ルールを参照してください。

トランザクションイベントデータを使用すると、ヒストグラムやパーセンタイルなどの追加情報を利用できます。

PythonエージェントのインスタンスによってNew Relicに送信される1分あたりの分析イベントの制限。

この設定を使用して、トランザクションイベントのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseの場合、この設定（transaction_events.attributes.enabled）がどのように設定されているかにかかわらず、トランザクションイベントに属性は送信されません。

属性がトランザクションイベントで有効になっている場合、このリストに含まれるすべての属性キーがトランザクションイベントで送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれるすべての属性キーは、トランザクションイベントには送信されません。トランザクションイベントから属性を除外しても、スパンイベントからは除外されないことに注意してください。詳細については、エージェント属性ルールを参照してください。

record_custom_event()経由でのEvent APIへのイベントの記録を許可します。

• PythonエージェントのインスタンスがNew Relicに送信できる1分あたりのカスタムイベントの数を制限します。

• AI監視用にエージェントを設定する場合、エージェントが最大量のLLMイベントを確実に捕捉できるようにするには、最大値（100000）に設定します。

  重要

  高セキュリティモードが有効になっている場合、この設定は無効になります。

有効にすると、エージェントは一部のデータベースドライバのデータストアインスタンスメトリクス（ホストやポートなど）を収集します。これらは、スロークエリトレースおよびトランザクショントレースでも報告されます。

有効にすると、エージェントは一部のデータベースドライバのデータベース名を収集します。データベース名は、スロークエリトレースとトランザクショントレースで報告されます。

ディストリビューティッド（分散）トレーシングを有効にします

これは、トレースにサンプリング済みのリモート親（つまり、トレースが上流サービスで発生した場合）がある場合に適用されるサンプラーです。サンプラーのオプションは以下のとおりです。

• adaptive デフォルトの動作です。トレースをサンプリングするかどうかの判断を適応型サンプリングアルゴリズムに委ねます。
• trace_id_ratio_based トレースをサンプリングするかどうかの判断をTrace ID Ratio Basedサンプリングアルゴリズムに委ねます。このオプションを使用する場合、比率が必要となるため、代わりにdistributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratioを使用してください。
• always_on：サンプリングされたリモート親を持つトレースを常にサンプリングします。
• always_off：サンプリングされたリモート親を持つトレースをサンプリングしません。

• 0（含まない）から1（含む）までの間の数値。

これは、トレースにサンプリング済みのリモート親（つまり、トレースが上流サービスで発生した場合）がない場合に適用されるサンプラーです。サンプラーのオプションは以下のとおりです。

• adaptive デフォルトの動作です。トレースをサンプリングするかどうかの判断を適応型サンプリングアルゴリズムに委ねます。
• trace_id_ratio_based トレースをサンプリングするかどうかの判断をTrace ID Ratio Basedサンプリングアルゴリズムに委ねます。このオプションを使用する場合、比率が必要となるため、代わりにdistributed_tracing.sampler.remote_parent_not_sampled.trace_id_ratio_based.ratioを使用してください。
• always_on：サンプリングされていないリモート親を持つトレースを常にサンプリングします。
• always_off：サンプリングされていないリモート親を持つトレースをサンプリングしません。

• 0（含まない）から1（含む）までの間の数値。

これは、トレースの開始時に適用されるサンプラーです。デフォルトでは、適応型サンプラーがルートサンプラーとして構成されています。サンプラーのオプションは以下のとおりです。

• adaptive デフォルトの動作です。トレースをサンプリングするかどうかの判断を適応型サンプリングアルゴリズムに委ねます。
• trace_id_ratio_based トレースをサンプリングするかどうかの判断をTrace ID Ratio Basedサンプリングアルゴリズムに委ねます。このオプションを使用する場合は、比率が必要となるため、代わりにdistributed_tracing.sampler.root.trace_id_ratio_based.ratioを使用してください。
• always_on：現在のサービスから発生し、エントリ呼び出しにディストリビューティッド（分散）トレーシングヘッダーが存在しないトランザクションを常にサンプリングします。
• always_off：現在のサービスから発生し、エントリ呼び出しにディストリビューティッド（分散）トレーシングヘッダーが存在しないトランザクションをサンプリングしません。

• 0（含まない）から1（含む）までの間の数値。

この設定は、Pythonエージェントがスパンを送信するかどうかをオンまたはオフにします。

• PythonエージェントのインスタンスによってNew Relicに送信される1分あたりのスパンイベントを制限します。
• AI監視のエージェントを設定する場合、エージェントが最大量のディストリビューティッド（分散）トレーシングを確実に捕捉できるようにするには、最大値（10000）に設定します。

この設定を使用すると、スパンイベントのすべての属性をオンまたはオフに切り替えることができます。ルートレベルのattributes.enabledがfalseの場合、この設定（span_events.attributes.enabled）がどのように設定されているかにかかわらず、属性はスパンイベントに送信されません。詳細については、エージェント属性ルールを参照してください。

スパンイベントで属性が有効になっている場合、このリストに含まれるすべての属性キーがスパンイベントで送信されます。詳しくはエージェント属性ルールを参照してください。

このリストに含まれる属性キーはすべて、スパンイベントでは送信されません。詳しくはエージェント属性ルールを参照してください。

PythonエージェントのインスタンスによってNew Relicに送信される1分あたりの分析イベントの制限。

PythonエージェントのインスタンスがNew Relicに送信できる1分あたりのカスタムイベントの数を制限します。

• PythonエージェントのインスタンスによってNew Relicに送信される1分あたりのスパンイベントを制限します。
• AI監視のエージェントを設定する場合、エージェントが最大量のディストリビューティッド（分散）トレーシングを確実に捕捉できるようにするには、最大値（10000）に設定します。

PythonエージェントのインスタンスによってNew Relicに送信される1分あたりのエラーイベントの制限。

PythonエージェントのインスタンスがNew Relicに送信できる1分あたりのMLイベントの数を制限します。

イベントループ情報を無効にするには、falseに設定してください。

イベントループ情報を生成する前に、トランザクションがイベントループをどのくらいの時間ブロックしている必要があるかを示す閾値（秒）。

有効にすると、エージェントはプロセスIDごとにランタイムメトリクスを生成して送信します。

有効にすると、エージェントはガベージコレクションのメトリクスを生成して送信します。

エージェントは、ガベージコレクターによって収集される最も一般的なオブジェクトタイプのオブジェクト数に関するメトリクスを報告します。この設定により、オブジェクトの種類ごとに、サンプリングされる各メトリクスの最大数を設定できます。

コードレベルのメトリクスでエージェント属性の収集を無効にするには、falseに設定してください。

コミットSHA。SHA全体、または最初の7文字（例：734713b）のみを使用することもできます。

リリースタグ（v0.1.209 またはリリース-209など）。

trueの場合、これらのサブ機能設定も有効であれば、ログ装飾と、ログイベントおよびロギングメトリクスの収集が有効になります。falseの場合、ロギング計装機能は有効になりません。

trueの場合、エージェントはアプリケーションから出力されるログレコードを取得し、New Relicに転送します。この設定を有効にするには、application_logging.enabledもtrueに設定する必要があります。

New Relicに転送されたすべてのログイベントにカスタムアトリビュートとして追加するキーと値のペアを持つハッシュ。値は「key1:value1;key2:value2」のように記述する必要があります。

エージェントがNew Relicへの送信用にログレコードにラベルを追加するかどうかを切り替えます。

ログにラベルを含めることを有効にした際に除外するラベル名のリスト（大文字と小文字を区別しない）。この属性はワイルドカードまたは正規表現をサポートしていません。

trueの場合、エージェントは利用可能なコンテキストデータ（追加情報、辞書メッセージ属性、ログフレームワークによって提供される属性）を取得し、その内容をNew Relicに転送されるログの属性として追加します。この動作は、application_logging.forwarding.context_dataセクションの設定で管理できます。

属性がcontext_dataで有効になっている場合、このリストで見つかったすべての属性キーがトランザクショントレースで送信されます。詳細については、エージェント属性ルールを参照してください。

このリストに含まれる属性キーはすべて、context_dataには送信されません。詳細については、エージェント属性ルールを参照してください。

New Relicに1分あたりに送信するログレコードの数。この設定により、ログ転送機能を使用する際の全体的なメモリ使用量を管理できます。

これをより低い値に設定して、送信されるログラインの量を減らします（ログサンプリングの原因になる場合があります）。これをより高い値に設定すると、より多くのログラインが送信されます。

各ログは、関連トランザクションと同じ優先度を受け取ります。トランザクション以外で発生するログは、ランダムな優先度を受け取ります。max_samples_storedによって制限されているため、一部のログが含まれない場合があります。たとえば、ロギングmax_samples_storedが10,000に設定され、トランザクション1に10,000のログエントリがある場合、トランザクション1のログエントリのみが記録されます。トランザクション1のログが10,000未満の場合、トランザクション1のすべてのログを受け取ります。まだスペースがある場合は、トランザクション2のすべてのログを受け取るなどとなります。

サンプリングされたトランザクションのすべてのログが記録された後も、 max_samples_storedの限度に達していない場合は、サンプリングに含まれていないトランザクションのログメッセージが送信されます。残っている場合は、トランザクション以外のログメッセージが記録されます。

New Relicに1分あたりに送信するログレコードの数。この設定により、ログ転送機能を使用する際の全体的なメモリ使用量を管理できます。

これをより低い値に設定して、送信されるログラインの量を減らします（ログサンプリングの原因になる場合があります）。これをより高い値に設定すると、より多くのログラインが送信されます。

各ログは、関連トランザクションと同じ優先度を受け取ります。トランザクション以外で発生するログは、ランダムな優先度を受け取ります。max_samples_storedによって制限されているため、一部のログが含まれない場合があります。たとえば、ロギングmax_samples_storedが10,000に設定され、トランザクション1に10,000のログエントリがある場合、トランザクション1のログエントリのみが記録されます。トランザクション1のログが10,000未満の場合、トランザクション1のすべてのログを受け取ります。まだスペースがある場合は、トランザクション2のすべてのログを受け取るなどとなります。

サンプリングされたトランザクションのすべてのログが記録された後も、 max_samples_storedの限度に達していない場合は、サンプリングに含まれていないトランザクションのログメッセージが送信されます。残っている場合は、トランザクション以外のログメッセージが記録されます。

trueの場合、エージェントはアプリケーションによって送信されたログ行に関連するメトリクスをキャプチャします。この設定を有効にするには、 application_logging.enabledもtrueである必要があります。

trueの場合、エージェントはエンティティ、ホスト、トレース、スパンにリンクするためのメタデータをログに追加します。この設定を有効にするには、application_logging.enabledもtrueである必要があります。

有効にすると、エージェントはGraphQLでのイントロスペクションクエリのためにトランザクションをキャプチャします。

有効にすると、エージェントはKombuのMessageTransactionsを消費します。

KombuでMessageTransactionsをキャプチャする際に無視するエクスチェンジをスペース区切りで列挙します。

有効にすると、エージェントはDjangoのミドルウェアを監視します。

ミドルウェアの計装が有効になっている場合、このリストにあるミドルウェア名が送信されます。リスト内の名前は、以下のようにスペースで区切ってください。

middleware1 middleware2 middleware3

ミドルウェアのフィルタリングに関するルールは、ミドルウェアのフィルタリングページに記載されています。

このリストに含まれるミドルウェア名は送信されません。リスト内の名前は、以下のようにスペースで区切ってください。

middleware1 middleware2 middleware3

ミドルウェアのフィルタリングに関するルールは、ミドルウェアのフィルタリングページに記載されています。

機械学習メトリクスのエージェントによる属性収集を有効にするには、trueに設定してください。

生の推論値を取得するには、trueに設定してください。

record_ml_event()経由で機械学習イベントをEvent APIに記録できるようにします。

PythonエージェントのインスタンスがNew Relicに送信できる1分あたりのMLイベントの数を制限します。

trueの場合、エージェントはAWS環境で実行されていることを自動検出します。

設定されている場合、アカウントIDが計装によって自動的に判別できない場合、エージェントはこのAWS account_idを使用してAWSエンティティを関連付けます。有効なAWSアカウントIDの例と、その確認方法については、AWSアカウント識別子管理に関するドキュメントを参照してください。

trueの場合、エージェントはAzure環境で実行されていることを自動検出します。

trueの場合、エージェントはGoogle Cloud Platform環境で実行されていることを自動検出します。

trueの場合、エージェントはPivotal Cloud Foundry環境で実行されていることを自動検出します。

trueの場合、エージェントはDockerで実行されていることを自動検出します。

有効にすると、エージェントは長時間実行されているSQLデータベースクエリから詳細を取得します。

スレッドプロファイリングセッションをスケジュール設定できます。スレッドプロファイラーは、アプリケーション内の各アクティブスレッドの呼び出しスタックのスナップショットを定期的にキャプチャして、統計的に代表的な呼び出しツリーを構築します。

サービス指向アーキテクチャ内でアプリとサービスを接続するクロスアプリケーショントレースを有効にします。

有効にすると、機密情報が誤って取得されるのを防ぐため、エラートレースは例外メッセージが削除されたうえでコレクターに送信されます。このオプションは、高セキュリティモードでは自動的に有効になります。

「許可」リストに含まれる例外は、たとえstrip_exception_messages.enabledがtrueであっても、メッセージは削除されません。「許可」リストは、例外タイプをスペースで区切った文字列で、それぞれがmodule:exception_nameの形式です。組み込み例外はexception_nameのようにリストします。module:を先頭に追加する必要はありません。

Example: Built-in exception and user-defined exception

KeyError my_module:MyException

デフォルトでは、エージェントは最初のトランザクション（Webトランザクションまたは非Webトランザクション）を受信した時点で起動します。エージェントはその後並行して起動し、この最初のリクエストが遅延しないようにします。ただし、エージェントは登録が完了するまでデータを収集できないため、この最初のリクエストの詳細は記録されません。これは、New Relic起動中に最初のいくつかの処理を遅らせないために、多くのWebアプリケーションで推奨される設定です。

これを上書きするには、起動タイムアウトを秒単位で設定します。その後、エージェントは最初の行為を一時停止し、登録が完了するのを待ちます。これは、プロセスが1回実行されてすぐに終了する単一のプログラム実行またはタスクを計装した場合に便利です。

プロセスがシャットダウンすると、エージェントはコレクターへの最後のアップロードを1回試みます。イシューの発生時にエージェントが無期限に実行されるのを防ぐため、shutdown_timeoutの閾値に達すると、プロセスは通常どおりシャットダウンします。このシャットダウンによりデータが失われる可能性がありますが、エージェントはアップロードプロセスにおいて主要なメトリクスデータを優先します。

バックグラウンドタスクキューシステム、特にプロセスごとに少数のタスクを実行するシステムでは、エージェントがプロセスシャットダウン時にすべてのデータをアップロードできるように、シャットダウンタイムアウトを長めに設定することをお勧めします。

ペイロードでデータ圧縮閾値に達すると、エージェントはデフォルトでgzip圧縮を使用してデータを圧縮します。設定オプションcompression_content_encodingをdeflateに設定すると、DEFLATE圧縮を使用できます。

この設定を有効にすると、エージェントの起動時にパッケージ情報とバージョン情報が取得され、APM環境タブに表示されます。

この設定を有効にすると、エージェントは起動スクリプトから詳細なトラブルシューティングメッセージをコンソール（標準出力）に直接送信します。これは、newrelic-admin起動スクリプト、代替のbootstrap/sitecustomize.py起動スクリプト、またはKubernetes APM自動アタッチの起動シーケンスでのクラッシュのデバッグに役立ちます。

これは、エージェントがKubernetesクラスタに組み込まれたことを報告するための情報提供用の設定です。

これは、エージェントがMicrosoft Azureコンテナアプリに組み込まれたことを報告するための情報提供用の設定です。

trueの場合、エージェントはHeroku dyno名をホスト名として使用します。

通常、エージェントは末尾にドットとプロセスIDが付いたdyno名を報告します（例：worker.3）。この末尾のデータを削除したい場合は、末尾データなしで報告したいプレフィックスを指定します（例：worker）。

.ini設定ファイルに以下を追加します。

[import-hook:MySQLdb]
enabled = false

または、.toml設定ファイルに以下を追加します。

[tool.newrelic.import-hook.MySQLdb]
enabled = false