構文
newrelic.agent.record_log_event(message, level=None, timestamp=None, attributes=None, application=None, priority=None)コンテキストでのロギングで使用するログ イベントを記録します。
要件
Python エージェント バージョン 8.5.0 以降。
説明
これにより、New Relic UI で表示およびクエリできるログ イベントが記録されます。監視対象のトランザクションのコンテキスト外でこれを使用する場合は、 applicationパラメータを使用してください。
パラメーター
パラメータ | 説明 |
|---|---|
文字列、辞書 | 必須。ログ メッセージを定義する これらの属性をレポートするには、 コンテキスト データ転送を有効にし、オプションで包含ルールと除外ルールを構成します。 |
ストリング | オプション。ログ レベルを定義します。デフォルトは |
浮く | オプション。ログ メッセージのタイムスタンプを定義します。デフォルトは |
辞書 | オプション。この辞書に含まれる項目は、接頭辞 これらの属性をレポートするには、 コンテキスト データ転送を有効にし、オプションで包含ルールと除外ルールを構成します。 |
物体 | オプション。監視対象のトランザクションのコンテキスト外でログ イベントを記録する場合は、これを使用して呼び出しを特定のアプリケーション オブジェクトに関連付けます。アプリケーション オブジェクトは、 |
物体 | オプション。ログイベントの優先度を設定します。優先順位がイベントのロギングにどのような影響を与えるかについては、 |
戻り値
なし。
例
バックグラウンド タスクでログ イベントを記録する
バックグラウンド タスクに関連付けられたログ イベントを記録する例を次に示します。
@newrelic.agent.background_task()def bg_task(): # do some type of work in this background task... application = newrelic.agent.application() newrelic.agent.record_log_event('My log message.', application)ログイベントをトランザクションに記録する
トランザクション内でログ イベントを記録する例:
def fetch(): newrelic.agent.record_log_event('Fetching data.') # do some type of work in this transaction...コンテキストデータ属性を使用してログイベントを記録する
メッセージ属性とコンテキスト属性を使用してログ イベントを記録する例を次に示します。
def fetch(product_id): newrelic.agent.record_log_event({"message": "Fetching data", "product_id": product_id}, attributes={"thread_id": threading.get_ident()}) # do some type of work in this transaction...