• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

Pythonエージェントの構成

Pythonエージェントでは、構成オプションを使用してデフォルトのエージェント動作エージェントを変更できます。

唯一必要な Python エージェント構成設定はです。 ライセンスキーは、エージェントがアプリケーション データを報告するアカウントを識別します。 アプリケーションをホストする方法に応じて、ライセンスキーは設定ファイルまたは環境変数を介して提供できます。

構成方法と優先順位

Pythonエージェントを構成する主な方法は、標準のインストールプロセスの一部として生成される構成ファイルを使用することです。UIでサーバー側の構成を使用するか、環境変数を使用して、限られた数の構成オプションを設定することもできます。WSGIリクエスト環境ディクショナリを使用して設定を渡すことにより、リクエストごとにいくつかの設定を指定することもできます。

Pythonエージェントは、次の優先順位に従って構成されます。

Python エージェントを使用すると、リクエストごとのオプションがサーバー側の設定をオーバーライドします。 有効にすると、サーバー側の値が空白のままであっても、サーバー側の構成はエージェント構成ファイル内のallに対応する値をオーバーライドします。 エージェント構成ファイルは環境変数をオーバーライドします。 環境変数はエージェントのデフォルトをオーバーライドします。

各構成方法の詳細な説明は次のとおりです。

複数の環境構成

エージェントは、 newrelicと呼ばれるエージェント構成セクションからプライマリ構成を読み取ります。追加のセクションで、特定のデプロイメント環境(開発、ステージング、本番など)のオーバーライドを提供できます。これらのセクションの前に[newrelic:environment]を付けます。ここで、 environmentは環境の名前に置き換えられます。

エージェントが環境ベースの構成を使用するように指定するには、次のいずれかの方法を使用します。

  • newrelic.agent.initialize()を呼び出すときは、2番目の引数として環境名を指定します。

    また

  • NEW_RELIC_ENVIRONMENT環境変数を環境名に設定します。

環境が指定されていない場合、エージェントはnewrelicエージェント構成セクションで指定されているデフォルト設定を使用します。

構成ファイルの基本構造は次のとおりです。

[newrelic]
... default settings
[newrelic:development]
... override settings
[newrelic:staging]
... override settings
[newrelic:production]
... override settings

一般的な構成設定

これらの設定は、エージェント構成ファイルで使用できます。

属性

属性は、境界トレース、トレース エラー、 、およびトランザクション イベントの情報を提供するキーの値のペアです。 以下の一般的なプロパティ設定を使用して 4 つの宛先すべての属性を構成するだけでなく、宛先ごとに属性を構成することもできます。

詳細については、 Pythonエージェント属性、属性の有効化と無効化、および属性の例を参照してください。

AIモニタリング

このセクションには、AI モニタリングを設定するための Python エージェント設定が含まれています。

重要

AI データをキャプチャするには、ディストリビューティッド(分散)トレーシングを有効にする必要があります。 Python エージェント バージョン 7.0.0.166 以降では、デフォルトで有効になっています。

トランザクショントレーサーの構成

重要

トランザクション名の末尾に角かっこ[suffix]を使用しないでください。エージェントは、名前から角かっこを自動的に削除します。代わりに、必要に応じて括弧(suffix)またはその他の記号を使用してください。

トランザクショントレースの詳細については、トランザクショントレースを参照してください。

トランザクションセグメントの構成

エージェント構成ファイルを介して使用できるトランザクションセグメント設定は次のとおりです。

エラーコレクターの構成

エージェント構成ファイルを介して使用できるエラーコレクター設定は次のとおりです。

ヒント

APMでのエラー構成の概要については、「APMでのエラーの 管理」を参照してください。

ブラウザの監視設定

エージェント構成ファイルを介して利用できるブラウザ監視設定は次のとおりです。

トランザクションイベントの設定

エージェント構成ファイルを介して使用できるトランザクションイベント設定は次のとおりです。

ヒント

これらの構成設定は、以前はanalytic_eventsと呼ばれていました。構成ファイルでまだanalytic_eventsを使用している場合は、 transaction_eventsを使用するようにエージェントを更新してください。

カスタムイベント設定

エージェント構成ファイルを介して使用できるカスタムイベント設定は次のとおりです。

データストアトレーサー設定

これらのデータストアトレーサー設定は、エージェント構成ファイルを介して利用できます。

分散トレース設定

分散トレースを使用すると、リクエストが分散システムを通過するときにたどるパスを確認できます。Pythonエージェントバージョン7.0.0.166以降では、分散トレースはデフォルトで有効になっています。

重要

分散トレースを有効にすると、クロスアプリケーション トレースが無効になり、APM 機能に他の影響が生じます。クロスアプリケーション トレースから移行する場合は、移行ガイドをお読みください。

詳細については、Pythonサービスの分散トレースを参照してください

設定は次のとおりです。

スパンイベント構成

スパンイベントは、分散トレース用に収集されます。スパンイベントを報告するには、分散トレースを有効にする必要があります。構成オプションは次のとおりです。

イベントハーベスト構成

イベントハーベスト設定は、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 として表示されます。

イベントハーベストの構成設定は次のとおりです。

イベントループの可視性設定

イベントループの可視性は、イベントループをブロックするトランザクションに関する情報を表示します。エージェントは、イベントループの制御を取得するためにかなりの時間待機したトランザクションに関する情報を生成します。設定は次のとおりです。

物理メモリのランタイムメトリクス

これらのランタイム メトリック設定は、エージェント設定ファイルから利用できます。

ガベージコレクションのランタイムメトリック設定

これらのガベージコレクションのランタイムメトリック設定は、エージェント構成ファイルを介して利用できます。

コードレベルのメトリクス設定

エージェントでのコード レベルのメトリックの構成には、次の設定を使用できます。

受信トレイ構成のエラー

次のタグのいずれかを設定すると、エラーが発生しているソフトウェアのバージョンを特定するのに役立ちます。

  • 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 ログを構成するを参照してください。

計装設定

これらのインストルメンテーション パッケージ固有の設定は、エージェント構成ファイルから利用できます。

機械学習の設定

エージェントでの機械学習データの構成には次の設定が使用できます。

その他の構成設定

エージェント構成ファイルを介して利用できるその他の設定を以下に示します。

Heroku

内蔵計装

Pythonエージェントは、さまざまなPythonパッケージ/モジュールをインストルメントします。このインストルメンテーションは、ターゲットPythonパッケージ/モジュールがアプリケーションによってインポートされた場合にのみ発生します。

デフォルトのインストルメンテーションを無効にするには、インストルメンテーションをトリガーしたモジュールの名前に対応する特別なimport-hookセクションを指定します。次に、 enabled設定をfalseに設定して、そのモジュールのインストルメンテーションを無効にします。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.