Javaエージェントのlogs in context設定

「コンテキスト内のログ」設定では、アプリケーションログ転送、ログの装飾、およびエージェント自身のログ記録動作を設定します。

Logs in Context

Javaエージェントバージョン7.6.0以降、Logs in contextのサポートがエージェントに追加され、サポート対象のロギングフレームワークで簡単に使用できるようになりました。コンテキストのログにJavaエージェントを使用するためのヒントについては、コンテキスト内のJavaログを参照してください。

これらの設定の変更はローカルエージェント設定ファイルで動的に行われ、変更を有効にするためにエージェントを再起動する必要はありません。設定の例：

application_logging:
  enabled: true
  forwarding:
    enabled: true
    max_samples_stored: 10000
    labels:
      enabled: false
      exclude:
    context_data:
      enabled: false
      include:
      exclude:
    log_level_denylist: debug
  metrics:
    enabled: true
  local_decorating:
      enabled: false

Logs in context設定はapplication_loggingセクションで設定します。これは、newrelic.config.application_loggingプレフィックス化システムプロパティを使用して上書きできます。利用可能な唯一のオプションは、以下のとおりです。

ログ転送

サポート対象のロギングフレームワークを使用しており、エージェントを使用してアプリケーションログをNew Relicに送信する場合は、forwardingセクションの下の設定から制御できます。newrelic.config.application_logging.forwardingプリフィックス化システムプロパティを使用して、この設定を上書きできます。利用可能なオプションは、以下のとおりです。

ログラベル（タグ）

Javaエージェントは、エージェント転送ログへのカスタムラベル（タグ）の追加をサポートしています。ラベルは、エージェント設定の最上位にあるラベルセクションから取得されます。この機能は、forwardingセクションの下にネストされているlabelsセクション内で有効にできます。newrelic.config.application_logging.forwarding.labelsプレフィックス化システムプロパティを使用して、この設定を上書きできます。利用可能なオプションには、以下が含まれます。

ログコンテキストデータ

Javaエージェントは、コンテキストデータ（logback/slf4jのマップされた診断コンテキスト、log4j2のThreadContext）をキャプチャし、その内容をNew Relicに転送されるログの属性として追加できます。これを制御するには、forwardingセクションの下にネストされているcontext_dataセクションの設定を使用します。newrelic.config.application_logging.forwarding.context_dataプリフィックス化システムプロパティを使用して、この設定を上書きできます。利用可能なオプションは、以下のとおりです。

ログレベル拒否リスト

Javaエージェントは、New Relicに転送されるLogEventsの生成から特定のログレベルを除外できます。

これを制御するには、forwardingセクションの下にネストされているlog_level_denylist設定オプションを使用します。この設定では、ログイベントを転送しないログレベルをカンマ区切りの文字列で指定します（例：log_level_denylist: "info, debug"）。ログレベル名は大文字と小文字を区別しませんが、それ以外は完全に一致する必要があります。newrelic.config.application_logging.forwarding.log_level_denylistプリフィックス化システムプロパティを使用して、この設定を上書きできます。使用可能なオプションは次のみです。

ログメトリクス

Javaエージェントは、個々のログラインを装飾して送信できるほか、ログメトリックデータをキャプチャすることもできます。このデータは、New Relic UIのログチャートに表示されます。metricsセクションでログメトリック設定を行えます。newrelic.config.application_logging.metricsプリフィックス化システムプロパティによってこの設定を上書きできます。使用可能な唯一のオプションは次のとおりです。

ログ装飾

local_decoratingセクションでログ装飾設定を行えます。これを使用して、ローカルログラインを装飾する方法を制御できます。newrelic.config.application_logging.local_decoratingプリフィックス化システムプロパティを使用して、この設定を上書きできます。利用可能な唯一のオプションは、以下のとおりです。

ロギングの設定

これは、一般的な設定変数の一部です。デバッグのため頻繁に微調整が行われるため、ここで分割されます。

ロギング設定変数の一部は動的であり、有効にするのにホストの再起動は不要です。たとえば、ログファイルの増加が速すぎる場合、log_levelの設定の詳細度を下げてレポートの頻度を減らすことができます。

ログのローテーションに影響を与える設定変数の優先順位と説明は次のとおりです。

• log_dailyがtrueの場合：

  • log_limit_in_kbytes値がゼロより大きい場合、複合トリガーポリシーが適用され、ログは1日に1回、または定義されたサイズに達したときにロールされ、最大log_file_count個のファイルが保持されます
  • log_limit_in_kbytes値がゼロの場合、ログは1日に1回ローリングされ、最大log_file_count個のファイルが保持されます

• log_dailyがfalseおよびlog_limit_in_kbytes > 0の場合、サイズベースのポリシーが設定され、定義されたサイズに達するとログがロールされ、最大log_file_count個のファイルが保持されます

• log_dailyがfalseおよびlog_limit_in_kbytes = 0の場合、ログファイルのローリングロジックは設定されません

増加率によっては、ログファイルのサイズが設定した値を若干超えることがあります。