Pythonエージェントでは、構成オプションを使用してデフォルトのエージェント動作エージェントを変更できます。
唯一必要な Python エージェント構成設定はです。 ライセンスキーは、エージェントがアプリケーション データを報告するアカウントを識別します。 アプリケーションをホストする方法に応じて、ライセンスキーは設定ファイルまたは環境変数を介して提供できます。
構成方法と優先順位
Pythonエージェントを構成する主な方法は、標準のインストールプロセスの一部として生成される構成ファイルを使用することです。UIでサーバー側の構成を使用するか、環境変数を使用して、限られた数の構成オプションを設定することもできます。WSGIリクエスト環境ディクショナリを使用して設定を渡すことにより、リクエストごとにいくつかの設定を指定することもできます。
Pythonエージェントは、次の優先順位に従って構成されます。
Python エージェントを使用すると、リクエストごとのオプションがサーバー側の設定をオーバーライドします。 有効にすると、サーバー側の値が空白のままであっても、サーバー側の構成はエージェント構成ファイル内のallに対応する値をオーバーライドします。 エージェント構成ファイルは環境変数をオーバーライドします。 環境変数はエージェントのデフォルトをオーバーライドします。
各構成方法の詳細な説明は次のとおりです。
通常、Pythonエージェントは、エージェントのホストシステム上のローカル構成ファイルから構成します。次のいずれかの方法を使用して、起動時に構成ファイルへのパスを指定します。
newrelic.agent.initialize()
を呼び出すときは、最初の引数として構成ファイルへのパスを指定します。
また
NEW_RELIC_CONFIG_FILE
環境変数を設定します。newrelic-admin
ラッパースクリプトを使用する場合、ラッパースクリプトはエージェントを自動的に呼び出すため、環境変数を使用する必要があります。
構成ファイルは、MicrosoftWindows .ini
ファイルと同様の構造を使用します。詳細については、PythonConfigParserモジュールのファイル形式のドキュメントを参照してください。
ヒント
サンプル構成ファイルは、Pythonエージェントにnewrelic/newrelic.ini
として含まれています。generate-config
コマンドを使用してnewrelic-admin
スクリプトから生成することも、ダウンロードリポジトリからコピーをダウンロードすることもできます。
サーバーサイド設定を使用すると、 New Relic UI で特定の設定を構成できます。 これにより、エージェントが複数のホストで実行されている場合でも、すべてのエージェントに変更が自動的に適用されます。 可能な場合、このドキュメントには、個々の構成オプションの下にサーバー側構成の UI ラベルがServer-side labelとして含まれています。
重要
サーバー側構成が有効な場合、エージェントは UI で設定される構成ファイル内の値couldを無視します。 UI 値が空の場合でも、エージェントはこれを空の文字列として扱い、エージェント構成ファイルを使用しません。
環境変数を使用すると、特定のコア設定のデフォルトをオーバーライドできます。 同等の設定がエージェント構成ファイルに明示的にリストされている場合、構成ファイルの設定が環境変数よりも優先されます。 利用可能な場合、環境変数は、以下の個々の構成オプションの下にEnviron variableとして記載されています。
単純な構成の場合、サーバー側の構成と組み合わせて環境変数を使用し、エージェント構成ファイルを完全に回避できます。これはHerokuのデフォルト設定であり、New Relicアドオンをインストールすると、必要な環境変数が自動的に入力されます。
New Relic CodeStreamを使用してIDEからパフォーマンスを監視する場合は、リポジトリをサービスに関連付け、ビルドSHAまたはリリースタグをエラーに関連付ける必要があります。
Environment variable | Configuration setting |
---|
NEW_RELIC_LICENSE_KEY
| license_key
|
NEW_RELIC_APP_NAME
| app_name
|
NEW_RELIC_MONITOR_MODE
| monitor_mode
|
NEW_RELIC_DEVELOPER_MODE
| developer_mode
|
NEW_RELIC_LOG
| log_file
|
NEW_RELIC_LOG_LEVEL
| log_level
|
NEW_RELIC_HIGH_SECURITY
| high_security
|
NEW_RELIC_PROXY_SCHEME
| proxy_scheme
|
NEW_RELIC_PROXY_HOST
| proxy_host
|
NEW_RELIC_PROXY_PORT
| proxy_port
|
NEW_RELIC_PROXY_USER
| proxy_user
|
NEW_RELIC_PROXY_PASS
| proxy_pass
|
NEW_RELIC_AUDIT_LOG
| audit_log_file
|
NEW_RELIC_STARTUP_TIMEOUT
| startup_timeout
|
NEW_RELIC_SHUTDOWN_TIMEOUT
| shutdown_timeout
|
NEW_RELIC_LABELS
| labels
|
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME
| process_host.display_name
|
NEW_RELIC_API_KEY
| api_key
|
NEW_RELIC_CA_BUNDLE_PATH
| ca_bundle_path
|
NEW_RELIC_DISTRIBUTED_TRACING_ENABLED
| distributed_tracing.enabled
|
NEW_RELIC_ANALYTICS_EVENTS_MAX_SAMPLES_STORED
| event_harvest_config.harvest_limits.analytic_event_data
|
NEW_RELIC_CUSTOM_INSIGHTS_EVENTS_MAX_SAMPLES_STORED
| event_harvest_config.harvest_limits.custom_event_data
|
NEW_RELIC_ML_INSIGHTS_EVENTS_MAX_SAMPLES_STORED
| event_harvest_config.harvest_limits.ml_event_data
|
NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED
| event_harvest_config.harvest_limits.span_event_data
|
NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
| event_harvest_config.harvest_limits.error_event_data
|
NEW_RELIC_FEATURE_FLAG
| feature_flag
|
特定のWSGIサーバーでは、リクエストごとにアプリ名とキャプチャ属性の設定を上書きできます。これは、リクエストごとのWSGI環境ディクショナリに渡される追加のキー/値のペアを定義できるWSGIサーバーで可能です。
これらの値は、文字列on
、 off
、 true
、 false
、 1
、および0
で設定します。Pythonコードを使用して実装された構成メカニズムから設定された場合、TrueまたはFalseに評価されるPythonオブジェクトも受け入れられます。
Apache / mod_wsgiサーバーでは、 SetEnv
ディレクティブを使用して構成設定をオーバーライドできます(オプションでLocation
またはDirectory
ブロック内)。たとえば、完全な仮想ホストのアプリ名、またはその仮想ホストのWSGIアプリケーションによって処理されるURLのサブセットのアプリ名を上書きできます。
特定のエージェント構成設定をオーバーライドできることに加えて、WSGI環境キーを使用して他の要求ごとの構成設定を設定できます。
true
に設定すると、このWebトランザクションは報告されません。
true
に設定すると、このWebトランザクションに対してApdexメトリックは生成されません。
true
に設定すると、ページの読み込みタイミング(実際のユーザー監視またはRUMと呼ばれることもあります)のためのJavaScriptヘッダー/フッターの自動挿入が無効になります。Webフレームワークで自動挿入が利用可能な場合にのみ適用されます。
重要
WSGIミドルウェアを使用してこれらの値を設定することは、Pythonエージェント自体のWSGIアプリケーションラッパーが外部スコープで適用された場合には機能しません。このような場合、同じ結果を得るには、エージェントAPIを呼び出す必要があります。
複数の環境構成
エージェントは、 newrelic
と呼ばれるエージェント構成セクションからプライマリ構成を読み取ります。追加のセクションで、特定のデプロイメント環境(開発、ステージング、本番など)のオーバーライドを提供できます。これらのセクションの前に[newrelic:environment]
を付けます。ここで、 environment
は環境の名前に置き換えられます。
エージェントが環境ベースの構成を使用するように指定するには、次のいずれかの方法を使用します。
環境が指定されていない場合、エージェントはnewrelic
エージェント構成セクションで指定されているデフォルト設定を使用します。
構成ファイルの基本構造は次のとおりです。
一般的な構成設定
これらの設定は、エージェント構成ファイルで使用できます。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_LICENSE_KEY
|
---|
New Relic アカウントのを指定します。 このキーは、アプリのメトリクスを New Relic アカウントに関連付けます。
タイプ | 弦 |
---|
デフォルト | Python Application
|
---|
始まる | リクエストごとのオプション、構成ファイル、環境変数 |
---|
リクエストごとのオプション | newrelic.app_name
|
---|
環境変数 | NEW_RELIC_APP_NAME
|
---|
NewRelicUIでデータを集約するために使用されるアプリケーション名。同時に複数のアプリにデータを報告するには、セミコロン;
で区切られた名前のリストを指定します。セミコロンの前にスペースを入れないでください。スペースを入れると、Python構成パーサーが名前を埋め込みコメントとして解釈します。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_MONITOR_MODE
|
---|
true
の場合、エージェントはアプリに関するパフォーマンスデータを収集し、このデータをデータコレクターに報告します。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_DEVELOPER_MODE
|
---|
true
の場合、エージェントはWebアプリを計測しますが、実際のデータは送信しません。このオフラインモードでは、アクティブなエージェントの料金は請求されません。
開発者モードを使用して、エージェントの新しいバージョンをテストするか、開発者環境でサードパーティパッケージに対してエージェントをテストします。エージェントが収集するメトリックはどこにも報告されないため、オフラインモードはAPMをローカルで実行する方法ではありません。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_LOG
|
---|
ログファイルの名前を設定します。これは、エージェントの問題をデバッグするのに役立ちます。これはデフォルトでは設定されていません。エージェントは、Webアプリプロセスの親ユーザーや、そのプロセスが書き込みを許可されているディレクトリを認識していないためです。詳細については、 Pythonエージェントのロギングを参照してください。
これをどのように設定しても、含まれているディレクトリとファイル自体のアクセス許可が正しいこと、およびWebアプリケーションを実行するユーザーがファイルに書き込めることを確認してください。
ヒント
アプリケーションの起動時の作業ディレクトリが確実でない限り、絶対パスを使用してください。ログファイルを書き出せない場合は、 stderr
を使用して標準エラー出力に出力することもできます。これにより、通常、Webサーバーのログに出力が表示されます。
タイプ | 弦 |
---|
デフォルト | info
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_LOG_LEVEL
|
---|
ログファイルの場所を設定している場合は、ログメッセージの詳細レベルを設定します。このlog_level
は、Pythonロギングモジュールのログレベルには影響しません。可能な値は、詳細の昇順で、 critical
、 error
、 warning
、 info
、およびdebug
です。
エージェントの問題を報告するには、最も便利な設定はdebug
です。ただし、 debug
は非常に迅速に多くの情報を生成するため、問題の再現にかかる時間よりも長くエージェントをこのレベルに維持しないでください。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_HIGH_SECURITY
|
---|
高セキュリティ モードでは、特定のセキュリティ設定が強制され、その設定が上書きされるのを防ぐため、機密データが当社に送信されることはありません。高セキュリティ モードを有効にすると、リクエスト パラメータが収集されず、生の SQL を送信できなくなります。
高セキュリティ モードを有効にするには、ローカルの.ini構成ファイルでtrue
に設定しますand Account settingsページから有効にします。 詳細については、 「高セキュリティ」を参照してください。
タイプ | 文字列 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_PROXY_SCHEME
NEW_RELIC_PROXY_HOST
NEW_RELIC_PROXY_PORT
NEW_RELIC_PROXY_USER
NEW_RELIC_PROXY_PASS
|
---|
デフォルトでは、Pythonエージェントはサーバーに直接接続しようとします。ホストとコレクターの間に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
。これは、 NEW_RELIC_PROXY_HOST
環境変数を使用してHTTPプロキシの詳細を設定した場合にも機能します。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_AUDIT_LOG
|
---|
監査ログファイルの名前を設定します。設定されている場合、エージェントは、監視対象プロセスとコレクターの間でやり取りされるメッセージの詳細をログに記録します。これにより、Pythonエージェントのセキュリティを評価できます。
起動時にアプリの作業ディレクトリがどうなるかわからない場合は、絶対パスを使用してください。これをどのように設定しても、含まれているディレクトリとファイル自体の権限が正しいことを確認してください。また、Webアプリの親ユーザーがファイルに書き込めることを確認してください。
注意
特に実稼働環境では、監査ログを継続的に使用しないでください。エージェントはログファイルを切り捨てたりローテーションしたりしないため、ログファイルは非常に急速に大きくなる可能性があります。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_LABELS
|
---|
タグを追加します。 name:value を コロン :
で区切って指定し、追加のタグをセミコロン ;
で区切ります。
labels = Server:One;Data Center:Primary
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_PROCESS_HOST_DISPLAY_NAME
|
---|
APMUIに表示されるホスト名を設定します。設定されている場合、これはエージェントが自動的にキャプチャするデフォルトのホスト名を上書きします。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_CA_BUNDLE_PATH
|
---|
ローカルCAバンドルへのパスの手動オーバーライド。このCAバンドルは、データ収集サービスによって提示されたSSL証明書を検証するために使用されます。
ヒント
この構成オプションは、Pythonエージェントバージョン4.2.0以降でのみ使用できます。
タイプ | 浮く |
---|
デフォルト | 0.5
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APDEX_T
|
---|
トランザクショントレースがこのしきい値を超えたときに記録します。形式は秒数です(小数点を使用できます)。
apdex_tの用語集エントリを参照してください
重要
これは、AWS Lambda で有効になっているserverless_mode
が設定されている場合、構成ファイルまたは環境変数でのみ設定されます。それ以外の場合、ローカルのapdex_t
値は、 apdex_f
値の設定に使用される UI アプリケーション設定の値によってオーバーライドされます。
属性
属性は、境界トレース、トレース エラー、 、およびトランザクション イベントの情報を提供するキーの値のペアです。 以下の一般的なプロパティ設定を使用して 4 つの宛先すべての属性を構成するだけでなく、宛先ごとに属性を構成することもできます。
詳細については、 Pythonエージェント属性、属性の有効化と無効化、および属性の例を参照してください。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、すべての属性をオンまたはオフにすることができます。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
属性が有効になっている場合、このリストにある属性キーが送信されます。リスト内のキーは、以下に示すようにスペースで区切る必要があります。
属性のルールは、エージェント属性ページにあります。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストにあるすべての属性キーが送信されるわけではありません。リスト内のキーは、以下に示すようにスペースで区切る必要があります。
属性のルールは、エージェント属性ページにあります。
AIモニタリング
このセクションには、AI モニタリングを設定するための Python エージェント設定が含まれています。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
環境変数 | NEW_RELIC_AI_MONITORING_ENABLED
|
---|
true
に設定すると、AI モニタリングが有効になります。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
環境変数 | NEW_RELIC_AI_MONITORING_STREAMING_ENABLED
|
---|
false
に設定すると、ストリーミングされた大規模言語モデル (LLM) データの概要とメッセージ イベントを記録するインストゥルメンテーションが無効になります。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
環境変数 | NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED
|
---|
false
に設定すると、エージェントは LLM イベントでキャプチャされた入力および出力コンテンツ (プロンプトや応答のテキスト文字列など) を省略します。 これは、LLM との間で送受信される機密データを記録したくない場合のオプションのセキュリティ設定です。
トランザクショントレーサーの構成
重要
トランザクション名の末尾に角かっこ[suffix]
を使用しないでください。エージェントは、名前から角かっこを自動的に削除します。代わりに、必要に応じて括弧(suffix)
またはその他の記号を使用してください。
トランザクショントレースの詳細については、トランザクショントレースを参照してください。
タイプ | 正のフロートまたは文字列( apdex_f ) |
---|
デフォルト | apdex_f
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Threshold
|
---|
トランザクショントレースを収集するタイミングのしきい値(秒単位)。コントローラアクションの応答時間がこのしきい値を超えると、エージェントはトランザクショントレースを記録します。有効な値は、任意の正の浮動小数点数、またはapdex_f
( apdex_tの4倍)です。
トランザクショントレーサーが有効になっている場合、エージェントはSQLステートメントを記録できます。レコーダには、 off
(SQLを送信しない)、 raw
(SQLステートメントを元の形式で送信する)、およびobfuscated
(数値リテラルと文字列リテラルを削除する)の3つのモードがあります。
ほとんどのWebフレームワーク(Djangoを含む)はSQLクエリをパラメーター化するため、クエリの入力に使用される値は実際には含まれていません。これらのフレームワークのいずれかでraw
モードを使用する場合、Pythonエージェントは値を挿入する前にのみSQLを認識します。パラメータ化されたSQLは、 obfuscated
モードによく似ています。
タイプ | 浮く |
---|
デフォルト | 0.5
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Stack trace threshold
|
---|
SQL呼び出しからスタックトレースを収集するタイミングのしきい値(秒単位)。SQLステートメントがこのしきい値を超えると、エージェントは現在のスタックトレースをキャプチャします。これは、長いSQL呼び出しがアプリケーションで発生した場所を特定するのに役立ちます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Enable SQL query plans?
|
---|
Pythonエージェントが遅いSQLクエリのクエリプランをキャプチャするかどうかを決定します。MySQLとPostgreSQLでのみサポートされています。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、トランザクショントレースのすべての属性をオンまたはオフにすることができます。ルートレベルのattributes.enabled
がfalse
の場合、この構成設定( transaction_tracer.attributes.enabled
)の設定に関係なく、トランザクショントレースに属性は送信されません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
トランザクショントレースで属性が有効になっている場合、このリストにあるすべての属性キーがトランザクショントレースで送信されます。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストにあるすべての属性キーは、トランザクショントレースで送信されるわけではありません。詳細については、エージェント属性ルールを参照してください。
指定された機能またはメソッドについて、エージェントは追加の機能タイミングインストルメンテーションをキャプチャします。これらの名前は、 module:function
またはmodule:class.function
の形式で指定してください。
関数名とクラス名のワイルドカード(グロブ)は、 fnmatchモジュールでサポートされているパターンを使用して可能です。モジュールパスはワイルドカードではサポートされていません。パターンをmodule:function*
またはmodule:class.*
の形式で指定します。
たとえば、以下のファイルのすべての検証関数に関数トレースを追加する場合は、次のようになります。
my-app / common / utils.py
def validate_credentials():
次の行をエージェント構成ファイルに追加して、ワイルドカードを使用してmy-app/common/utils.py
内のすべての検証関数への関数トレースを含めます。
my-app / newrelic.ini
transaction_tracer.function_trace = common.utils:validate*
トランザクションセグメントの構成
エージェント構成ファイルを介して使用できるトランザクションセグメント設定は次のとおりです。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、トランザクショントレースのセグメントのすべての属性をオンまたはオフにすることができます。ルートレベルのattributes.enabled
がfalse
の場合、この構成設定( transaction_segments.attributes.enabled
)の設定に関係なく、トランザクショントレースのセグメントに属性は送信されません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
トランザクショントレースのセグメントで属性が有効になっている場合、このリストにあるすべての属性キーは、トランザクショントレースのセグメントで送信されます。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストにあるすべての属性キーは、トランザクショントレースのセグメントで送信されるわけではありません。詳細については、エージェント属性ルールを参照してください。
エラーコレクターの構成
エージェント構成ファイルを介して使用できるエラーコレクター設定は次のとおりです。
ヒント
APMでのエラー構成の概要については、「APMでのエラーの 管理」を参照してください。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Enable error collection?
|
---|
有効にすると、エラーコレクタはキャッチされなかった例外に関する情報をキャプチャします。
特定のエラーの収集を停止するには、これを無視するPython例外タイプ名のスペースで区切られたリストに設定します。例外名には形式module:class
を使用します。
ヒント
エージェントのバージョン6.4.0より前では、この設定の名前はerror_collector.ignore_errors
でした。構成ファイルでまだignore_errors
を使用している場合は、 ignore_classes
を使用するようにエージェントを更新してください。
タイプ | 弦 |
---|
デフォルト | 100-102 200-208 226 300-308 404
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Ignore these status codes
|
---|
エージェントがエラーとして記録するのではなく無視する必要があるHTTPステータスコードを一覧表示します。追加の状況コードをスペースで区切られた整数としてリストし、開始値と終了値の間にハイフン-
区切り文字を使用して範囲を指定します。デフォルトコードの1つを許可リストに追加するには、コードの前に感嘆符!
を付けます。
一部のフレームワークは例外を使用してHTTP応答を返さないため、この設定は一部のWebフレームワークとのみ互換性があります。
ヒント
この構成オプションは、Pythonエージェントバージョン6.4.0以降のサーバー側構成でのみ設定できます。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Expect these error class names
|
---|
指定された例外クラスがエラー率またはApdexスコアに影響を与えずに、エラーをAPMに報告するのを防ぎます。これを、予期されるPython例外タイプ名のスペースで区切られたリストに設定します。例外名には形式module:class
を使用します。
ヒント
この構成オプションは、Pythonエージェントバージョン6.4.0以降でのみ使用できます。
タイプ | 弦 |
---|
デフォルト | (無し) |
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Expect these status codes
|
---|
指定されたHTTPステータスコードがエラー率またはApdexスコアに影響を与えずに、エラーをAPMに報告するのを防ぎます。ステータスコードをスペースで区切られた整数としてリストし、開始値と終了値の間にハイフン-
区切り文字を使用して範囲を指定します。リスト内のコードの1つを無効にするには、コードの前に感嘆符!
を付けます。
一部のフレームワークは例外を使用してHTTP応答を返さないため、この設定は一部のWebフレームワークとのみ互換性があります。
ヒント
この構成オプションは、Pythonエージェントバージョン6.4.0以降でのみ使用できます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、トレースされたエラーのすべての属性をオンまたはオフにすることができます。attributes.enabled
がルートレベルでfalse
の場合、この構成設定( error_collector.attributes.enabled
)がどのように設定されているかに関係なく、トレースされたエラーに属性は送信されません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
トレースされたエラーに対して属性が有効になっている場合、このリストにあるすべての属性キーがトレースされたエラーで送信されます。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストで見つかった属性キーは、トレースされたエラーでは送信されません。詳細については、エージェント属性ルールを参照してください。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
有効にすると、エラーコレクターは高度な分析のためにイベントデータをキャプチャします。詳細については、 APMエラーを参照してください。
ブラウザの監視設定
エージェント構成ファイルを介して利用できるブラウザ監視設定は次のとおりです。
タイプ | 弦 |
---|
デフォルト | text/html
|
---|
始まる | 構成ファイル |
---|
ブラウザ監視エージェントが自動計測するHTML Content-Type
を指定します。スペースで区切られたリストにエントリを追加します。
HTMLページの応答を生成し、 application/xhtml+xml
のContent-Type
を使用している場合は、次を使用して、許可されたコンテンツタイプをオーバーライドし、このコンテンツタイプとデフォルトのtext/html
の両方を一覧表示できます。
browser_monitoring.content_type = text/html application/xhtml+xml
重要
ブラウザ監視JavaScriptスニペットは、ページがapplication/xhtml+xml
として検証されないようにしますが、ページはエンドユーザーブラウザで読み込まれてレンダリングされる必要があります。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、ブラウザ監視のすべての属性をオンまたはオフにすることができます。これは、ページビューイベントに送信されるデータです。ルートレベルでattributes.enabled
がfalseの場合、構成設定( browser_monitoring.attributes.enabled
)がどのように設定されているかに関係なく、ブラウザの監視で属性は送信されません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
属性がbrowser_monitoring
に対して有効になっている場合、このリストにあるすべての属性キーがページビューで送信されます。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストにあるすべての属性キーは、ページビューでは送信されません。詳細については、エージェント属性ルールを参照してください。
トランザクションイベントの設定
エージェント構成ファイルを介して使用できるトランザクションイベント設定は次のとおりです。
ヒント
これらの構成設定は、以前はanalytic_events
と呼ばれていました。構成ファイルでまだanalytic_events
を使用している場合は、 transaction_events
を使用するようにエージェントを更新してください。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、トランザクションイベントのすべての属性をオンまたはオフにすることができます。ルートレベルでattributes.enabled
がfalse
の場合、この構成設定( transaction_events.attributes.enabled
)の設定に関係なく、トランザクションイベントに属性は送信されません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
属性がトランザクションイベントに対して有効になっている場合、このリストにあるすべての属性キーがトランザクションイベントで送信されます。詳細については、エージェント属性ルールを参照してください。
このリストにあるすべての属性キーは、トランザクションイベントでは送信されません。トランザクションイベントから属性を除外しても、スパンイベントから除外されないことに注意してください。詳細については、エージェント属性ルールを参照してください。
カスタムイベント設定
エージェント構成ファイルを介して使用できるカスタムイベント設定は次のとおりです。
データストアトレーサー設定
これらのデータストアトレーサー設定は、エージェント構成ファイルを介して利用できます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
有効にすると、エージェントは一部のデータベースドライバーのデータストアインスタンスメトリック(ホストやポートなど)を収集します。これらは、低速のクエリトレースとトランザクショントレースでも報告されます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
有効にすると、エージェントは一部のデータベースドライバーのデータベース名を収集します。データベース名は、低速のクエリトレースとトランザクショントレースで報告されます。
分散トレース設定
分散トレースを使用すると、リクエストが分散システムを通過するときにたどるパスを確認できます。Pythonエージェントバージョン7.0.0.166以降では、分散トレースはデフォルトで有効になっています。
詳細については、Pythonサービスの分散トレースを参照してください。
設定は次のとおりです。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_DISTRIBUTED_TRACING_ENABLED
|
---|
分散トレースを有効にします
スパンイベント構成
スパンイベントは、分散トレース用に収集されます。スパンイベントを報告するには、分散トレースを有効にする必要があります。構成オプションは次のとおりです。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、Pythonエージェントがスパンを送信するかどうかをオンまたはオフにすることができます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
この設定を使用して、スパンイベントのすべての属性をオンまたはオフにすることができます。ルートレベルのattributes.enabled
がfalse
の場合、この構成設定( span_events.attributes.enabled
)の設定に関係なく、スパンイベントに属性は送信されません。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
スパンイベントに対して属性が有効になっている場合、このリストにあるすべての属性キーがスパンイベントで送信されます。詳細については、エージェント属性ルールを参照してください。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル |
---|
このリストにあるすべての属性キーは、スパンイベントで送信されるわけではありません。詳細については、エージェント属性ルールを参照してください。
イベントハーベスト構成
イベントハーベスト設定は、NewRelicに送信されるイベントタイプデータの量を制限します。これらの設定を使用するときは、次の重要な点を考慮してください。
- イベントハーベスト設定は、アプリケーション全体ではなく、エージェントの単一インスタンスの制限に影響します。アプリケーション全体に制限を設定する方法については、以下の使用例を参照してください。
- リアルタイム ストリーミングは5 秒ごと (1 分あたり 12 回) にデータを送信しますが、イベント収集設定はminuteあたりのイベントのレートに影響します。 リアルタイム ストリーミングを有効または無効にする場合、これらの設定を変更する必要はありません。
- リアルタイム ストリーミング (デフォルトで有効) を使用すると、New Relic はエンティティのイベント収集制限を 5 秒間隔で表示します。これは、たとえば、構成ファイルで 1200 の制限値を設定すると、New Relic では 100 として表示されることを意味します。
使用例
アプリケーションが10個のホストにデプロイされ、それぞれがホストごとに4つのプロセスを実行しているとします。アプリケーション全体でスパンイベントの数を1分あたり10,000イベントに制限するには、その数を10ホストで割ります。次に、ホストごとに4つのプロセスで再度分割します。
10000 /(10 * 4)= 250
その計算に基づいて、最終的な設定は次のようになります。
event_harvest_config.harvest_limits.span_event_data= 250
ヒント
New Relic がデータを収集する方法 (1 分間に 12 回) により、イベント データ数が 12 未満の場合、New Relic では 0 として表示されます。
イベントハーベストの構成設定は次のとおりです。
タイプ | 整数 |
---|
デフォルト | 1200
|
---|
始まる | 構成ファイル |
---|
環境変数 | NEW_RELIC_ANALYTICS_EVENTS_MAX_SAMPLES_STORED
|
---|
PythonエージェントのインスタンスからNewRelicに送信される1分あたりの分析イベントの制限。
タイプ | 整数 |
---|
デフォルト | 3600
|
---|
始まる | 構成ファイル |
---|
環境変数 | NEW_RELIC_CUSTOM_INSIGHTS_EVENTS_MAX_SAMPLES_STORED
|
---|
- Python エージェントのインスタンスがNew Relicに送信できる 1 分あたりのカスタムイベントの数を制限します。
- AI モニタリング用にエージェントを構成するときは、エージェントが最大量の LLM イベントをキャプチャできるように最大値
100000
に設定します。
タイプ | 整数 |
---|
デフォルト | 2000
|
---|
始まる | 構成ファイル |
---|
環境変数 | NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED
|
---|
- PythonエージェントのインスタンスからNewRelicに送信される1分あたりのスパンイベントの制限。
- AI モニタリングのエージェントを構成する場合、エージェントが最大量のディストリビューティッド(分散)トレーシングを確実に捕捉できるように、最大値
10000
に設定します。
タイプ | 整数 |
---|
デフォルト | 100 |
---|
始まる | 構成ファイル |
---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
|
---|
PythonエージェントのインスタンスからNewRelicに送信される1分あたりのエラーイベントの制限。
イベントループの可視性設定
イベントループの可視性は、イベントループをブロックするトランザクションに関する情報を表示します。エージェントは、イベントループの制御を取得するためにかなりの時間待機したトランザクションに関する情報を生成します。設定は次のとおりです。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
イベントループ情報を無効にするには、これをfalse
に設定します。
トランザクションがイベントループ情報を生成する前にイベントループをブロックする必要がある時間のしきい値(秒単位)。
物理メモリのランタイムメトリクス
これらのランタイム メトリック設定は、エージェント設定ファイルから利用できます。
タイプ | ブール値 |
---|
デフォルト | true |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_MEMORY_RUNTIME_PID_METRICS_ENABLED
|
---|
有効にすると、エージェントはプロセス ID ごとにランタイム メトリックを生成して送信します。
ガベージコレクションのランタイムメトリック設定
これらのガベージコレクションのランタイムメトリック設定は、エージェント構成ファイルを介して利用できます。
タイプ | ブール値 |
---|
デフォルト | false |
---|
始まる | 構成ファイル |
---|
有効にすると、エージェントはガベージコレクションメトリックを生成して送信します。
エージェントは、ガベージコレクターによって収集されている最も一般的なオブジェクトタイプのオブジェクトカウントメトリックを報告します。この設定では、オブジェクトタイプごとに、サンプリングされる個々のメトリックの最大数を設定できます。
コードレベルのメトリクス設定
エージェントでのコード レベルのメトリックの構成には、次の設定を使用できます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル |
---|
これをfalse
に設定して、コード レベルのメトリックのエージェント属性収集を無効にします。
コミット sha。sha 全体を使用することも、最初の 7 文字だけを使用することもできます (例: 734713b)。
リリースタグ(v0.1.209など)またはリリース-209)。
受信トレイ構成のエラー
次のタグのいずれかを設定すると、エラーが発生しているソフトウェアのバージョンを特定するのに役立ちます。
NEW_RELIC_METADATA_SERVICE_VERSION
デプロイされているコードのバージョン (多くの場合、1.2.3 などのセマンティック バージョン) を含むイベント データに tags.service.version が作成されますが、常にそうとは限りません。NEW_RELIC_METADATA_RELEASE_TAG
リリースタグを含むイベントデータに tags.releaseTag を作成します (v0.1.209 など)またはリリース-209)。NEW_RELIC_METADATA_COMMIT
コミット SHA を含むイベント データに対して tags.commit を作成します。sha 全体を使用することも、最初の 7 文字だけを使用することもできます (例: 734713b)。
エラー受信箱の今後のリリースでは、ソフトウェアのどのバージョンでエラーが発生しているかを自動的に追跡します。バージョン データもCodeStreamに表示されます。
アプリケーションログ設定
エージェントでのアプリケーションロギングの設定には、次の設定を使用できます。
Python エージェントのログを構成するためのヒントについては、コンテキストで Python ログを構成するを参照してください。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_ENABLED
|
---|
true
の場合、これらのサブ機能構成も有効になっている場合は、ログの装飾とログイベントおよびログメトリックの収集を有効にします。false
の場合、ロギングインストルメンテーション機能は有効になりません。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED
|
---|
true
の場合、エージェントはアプリケーションによって発行されたログレコードをキャプチャし、それらをNewRelicに転送します。この設定を有効にするには、 application_logging.enabled
もtrue
である必要があります。
注意
既存のログ転送ソリューションを使用してアプリケーションのログをすでにNewRelicに送信している場合は、ログデータの重複が請求されないように、エージェントでログ転送を有効にする前に必ず無効にしてください。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED
|
---|
true
の場合、エージェントは利用可能なコンテキスト データ (エクストラ、辞書メッセージ属性、ロギング フレームワークによって提供される属性) をキャプチャし、その内容を New Relic に転送されるログの属性として追加します。この動作は、 application_logging.forwarding.context_data
セクションの設定を通じて制御できます。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE
|
---|
属性がcontext_data
に対して有効になっている場合、このリストで見つかったすべての属性キーがトランザクション追跡で送信されます。詳細については、 「エージェント属性ルール」を参照してください。
重要
コンテキスト属性を追加するとき、エージェントは、ロギング フレームワーク コンテキストからの属性の場合はcontext.
、辞書メッセージ コンテキストからの属性の場合はmessage.
をキーの先頭に付けます。
これらのプレフィックスは、包含/除外フィルタリング ルールと照合する場合には含まれません。
タイプ | 文字列のリスト |
---|
デフォルト | (無し) |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE
|
---|
このリストにあるすべての属性キーは context_data で送信されるわけではありません。詳細については、 「エージェント属性ルール」を参照してください。
重要
コンテキスト属性を追加するとき、エージェントは、ロギング フレームワーク コンテキストからの属性の場合はcontext.
、辞書メッセージ コンテキストからの属性の場合はmessage.
をキーの先頭に付けます。
これらのプレフィックスは、包含/除外フィルタリング ルールと照合する場合には含まれません。
タイプ | 整数 |
---|
デフォルト | 10000 |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED
|
---|
NewRelicに1分あたりに送信するログレコードの数。この設定は、ログ転送機能を使用するときの全体的なメモリ消費を制御します。
これをより低い値に設定して、送信されるログラインの量を減らします(ログサンプリングの原因になる場合があります)。これをより高い値に設定すると、より多くのログラインが送信されます。
各ログは、関連するトランザクションと同じ優先度を受け取ります。トランザクション外で発生したログには、ランダムな優先度が割り当てられます。max_samples_stored
によって制限されているため、一部のログは含まれない場合があります。たとえば、ロギングmax_samples_stored
が 10,000 に設定され、トランザクション 1 に 10,000 のログ エントリがある場合、トランザクション 1 のログ エントリのみが記録されます。トランザクション 1 のログが 10,000 未満の場合、トランザクション 1 のすべてのログを受け取ります。まだスペースがある場合は、トランザクション 2 のすべてのログを受け取ります。
サンプリングされたトランザクションのすべてのログが記録され、それらがmax_samples_stored
の制限に達していない場合、サンプリングに含まれていなかったトランザクションのログ メッセージが送信されます。残っている場合は、トランザクション以外のログ メッセージが記録されます。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED
|
---|
true
の場合、エージェントは、アプリケーションによって送信されているログ行に関連するメトリックをキャプチャします。この設定を有効にするには、 application_logging.enabled
もtrue
である必要があります。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED
|
---|
true
の場合、エージェントはログをメタデータで装飾して、エンティティ、ホスト、トレース、およびスパンにリンクします。この設定を有効にするには、 application_logging.enabled
もtrue
である必要があります。
計装設定
これらのインストルメンテーション パッケージ固有の設定は、エージェント構成ファイルから利用できます。
タイプ | ブール値 |
---|
デフォルト | false |
---|
始まる | 構成ファイル |
---|
環境変数 | NEW_RELIC_INSTRUMENTATION_GRAPHQL_CAPTURE_INTROSPECTION_QUERIES
|
---|
有効にすると、エージェントは GraphQL でイントロスペクション クエリのトランザクションをキャプチャします。
機械学習の設定
エージェントでの機械学習データの構成には次の設定が使用できます。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_MACHINE_LEARNING_ENABLED
|
---|
機械学習指標のエージェント属性収集を有効にするには、 true
に設定します。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_MACHINE_LEARNING_INFERENCE_EVENT_VALUE_ENABLED
|
---|
生の推論値のキャプチャを有効にするには、 true
に設定します。
その他の構成設定
エージェント構成ファイルを介して利用できるその他の設定を以下に示します。
true
の場合、エージェントはAWS環境で実行されていることを自動的に検出します。
true
の場合、エージェントはAzure環境で実行されていることを自動的に検出します。
true
の場合、エージェントはGoogleCloudPlatform環境で実行されていることを自動的に検出します。
true
の場合、エージェントはPivotalCloudFoundry環境で実行されていることを自動的に検出します。
true
の場合、エージェントはDockerで実行されていることを自動的に検出します。
有効にすると、エージェントは長時間実行されるSQLデータベースクエリから詳細をキャプチャします。
タイプ | ブール値 |
---|
デフォルト | true
|
---|
始まる | サーバー側の構成、構成ファイル |
---|
サーバー側のラベル | Enable thread profiler?
|
---|
スレッドプロファイリングセッションをスケジュールできます。スレッドプロファイラーは、アプリケーション内のアクティブなスレッドごとに呼び出しスタックのスナップショットを定期的にキャプチャして、統計的に代表的な呼び出しツリーを構築します。
タイプ | ブール値 |
---|
デフォルト | false
|
---|
始まる | 構成ファイル |
---|
有効にすると、例外メッセージはコレクターに送信される前にエラー トレースから削除され、機密情報が誤って取得されるのを防ぎます。このオプションは、高セキュリティ モードでは自動的に有効になります。
許可リストにリストされている例外は、 strip_exception_messages.enabled
がtrue
であっても、メッセージが削除されることはありません。許可リストは、スペースで区切られた例外タイプの文字列であり、それぞれmodule:exception_name
の形式です。組み込みの例外をexception_name
としてリストします;それらの前にmodule:
を付ける必要はありません。
Example: Built-in exception and user-defined exception
KeyError my_module:MyException
タイプ | 浮く |
---|
デフォルト | 0.0
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_STARTUP_TIMEOUT
|
---|
デフォルトでは、エージェントは最初のトランザクション ( web または non-webのいずれか) を受け取ると開始します。その後、エージェントは並行して開始し、この最初のリクエストが遅れないようにします。ただし、エージェントは登録が完了するまでデータを収集できないため、この最初の要求の詳細は記録されません。これは、New Relic の起動中に最初の 2 つのトランザクションを遅延させないために、ほとんどの Web アプリケーションで推奨される構成です。
これを無効にするために、起動タイムアウトを秒単位で設定できます。その後、エージェントは最初のトランザクションを一時停止し、登録が完了するのを待ちます。これは、プロセスが 1 回実行されてすぐに終了する、単一のプログラム実行またはタスクを計測する場合に役立つ場合があります。
重要
startup_timeout
はアプリの起動を遅らせるため、ウェブアプリケーションではなく、バックグラウンドタスクキューイングシステムの起動タイムアウトのみを設定することをお勧めします。
タイプ | 浮く |
---|
デフォルト | 2.5
|
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_SHUTDOWN_TIMEOUT
|
---|
プロセスのシャットダウン時に、エージェントはコレクターへの最後のアップロードを1回試行します。問題が発生した場合にエージェントが無期限に実行されるのを防ぐために、 shutdown_timeout
のしきい値に達すると、プロセスは正常にシャットダウンします。このシャットダウンによりデータが失われる可能性がありますが、エージェントはアップロードプロセス中に主要なメトリックデータを優先します。
バックグラウンドタスクキューイングシステム、特にプロセスごとに少数のタスクを実行するシステムの場合、エージェントがプロセスのシャットダウン時にすべてのデータをアップロードできるように、シャットダウンタイムアウトを増やすことができます。
ヒント
Apacheおよび他の多くのWebサーバーには3.0秒のプロセス終了タイムアウトがあるため、エージェントはデフォルトで2.5秒のタイムアウトになります。エージェントは2.5秒で終了し、プロセスに登録されているatexit
クリーンアップコードを実行できるようにします。
ペイロードでデータ圧縮しきい値に達した場合、エージェントはデフォルトでgzip圧縮を使用してデータを圧縮します。構成オプションcompression_content_encoding
をdeflate
に設定して、deflate圧縮を使用できます。
タイプ | ブール値 |
---|
デフォルト | true |
---|
始まる | 構成ファイル、環境変数 |
---|
環境変数 | NEW_RELIC_PACKAGE_REPORTING_ENABLED
|
---|
この設定を有効にすると、エージェントの起動時にパッケージとバージョン情報がキャプチャされ、APM 環境タブに表示されます。
ヒント
多数のパッケージを持つアプリケーションでは、この設定を有効にすると、すべてのパッケージとバージョン情報をキャプチャするため、CPU スパイクが発生する可能性があります。 そのような場合には、この設定を無効にすることをお勧めします。
注意
この設定を無効にすると、古いパッケージの脆弱性を検出する機能が無効になります。
タイプ | ブール値 |
---|
デフォルト | false |
---|
始まる | 環境変数 |
---|
環境変数 | NEW_RELIC_STARTUP_DEBUG
|
---|
この設定を有効にすると、エージェントは起動スクリプトから詳細なトラブルシューティング メッセージをコンソール (STDOUT) に直接送信します。 これは、 newrelic-admin
起動スクリプト、代替のbootstrap/sitecustomize.py
起動スクリプト、または Kubernetes APM 自動接続の起動シーケンスでのクラッシュをデバッグするのに役立ちます。
注意
この環境変数設定には対応する構成ファイル設定はありません。関連するコードは構成ファイルが読み取られる前に実行されるためです。 エージェントの起動後に包括的なデバッグ ログを記録するには、ログ レベルをdebug
に設定します。
タイプ | ブール値 |
---|
デフォルト | false |
---|
始まる | 環境変数 |
---|
環境変数 | NEW_RELIC_K8S_OPERATOR_ENABLED
|
---|
これは、エージェントがKubernetesクラスタに挿入されたときにレポートするために使用される情報設定です。
注意
この設定では、エージェントのこの機能が有効または無効になるわけではありません。
タイプ | ブール値 |
---|
デフォルト | false |
---|
始まる | 環境変数 |
---|
環境変数 | NEW_RELIC_AZURE_OPERATOR_ENABLED
|
---|
これは、エージェントが Microsoft Azure コンテナー アプリに挿入されたときにレポートするために使用される情報設定です。
注意
この設定では、エージェントのこの機能が有効または無効になるわけではありません。
Heroku
タイプ | ブール値 |
---|
デフォルト | true
|
---|
環境変数 | NEW_RELIC_HEROKU_USE_DYNO_NAMES
|
---|
true
の場合、エージェントはホスト名としてHerokudyno名を使用します。
タイプ | 配列 |
---|
デフォルト | ["scheduler", "run"]
|
---|
環境変数 | NEW_RELIC_HEROKU_DYNO_NAME_PREFIXES_TO_SHORTEN
|
---|
通常、エージェントは、末尾にドットとプロセス ID を付けて dyno 名を報告します (例: worker.3 )。末尾のデータなしで報告するプレフィックスを指定することで、この末尾のデータを削除できます (たとえば、 worker )。
内蔵計装
Pythonエージェントは、さまざまなPythonパッケージ/モジュールをインストルメントします。このインストルメンテーションは、ターゲットPythonパッケージ/モジュールがアプリケーションによってインポートされた場合にのみ発生します。
デフォルトのインストルメンテーションを無効にするには、インストルメンテーションをトリガーしたモジュールの名前に対応する特別なimport-hook
セクションを指定します。次に、 enabled
設定をfalse
に設定して、そのモジュールのインストルメンテーションを無効にします。