構文
newrelic.agent.application(name=None)
エージェントが監視しているアプリに対応するオブジェクトを返します; いくつかのPythonエージェントAPIコールで必要です。
説明
この呼び出しは、エージェントが監視しているアプリケーションに対応するオブジェクトを返します。 name
の値が設定されていない場合は、Pythonのエージェント設定で設定された name が使用されます。
返されたアプリケーションオブジェクトは、パブリックAPIを提示していませんが、他のAPIコールで必要とされています。
重要
この呼び出しは、アプリケーションオブジェクトを返すだけです。アプリケーションのデータコレクタへの登録がまだ行われていない場合は、登録は行われません。
パラメータ
パラメーター | 説明 |
---|---|
文字列 | オプションです。アプリケーションの名前を指定します。設定されている場合は、Pythonエージェントの設定で設定されたアプリケーション名よりも優先されます。 |
戻り値
アプリケーションオブジェクトを返します。このオブジェクト自体はパブリックなAPIを提供しませんが、いくつかの他のAPIコールで必要となります。
例
アプリケーション・オブジェクトの生成と使用
アプリケーションオブジェクトを生成するには
import newrelic.agent
app = newrelic.agent.application()
他のPythonエージェントAPIコールの中には、アプリケーションオブジェクトをパラメータとして受け取るものがあります。その例として、 notice_error
のコールをご覧ください。