Javaエージェントのエラーコレクター設定

エラー収集を有効にします。

指定された例外クラス名は無視され、エラー率やApdexスコアには影響はなく、またAPMにレポートされません。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

例えば：

error_collector:
  ignore_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

環境変数を使用して、無視する例外クラス名を一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_IGNORE_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

エージェントが無視すべき例外クラス名を指定します。無視されたメッセージはエラー率やApdexスコアには影響を与えず、またAPMにレポートされません。以下で構成されるyamlペアを含みます。

• APMにレポートされない完全修飾例外クラス名

  と

• 一致する例外messageのリスト（少なくとも1つ必要）

  例外クラス名がエラーと一致するが、メッセージは一致しない場合、そのエラーは無視will not。メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。 Cannot be specified by system property.

  この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

  例えば：

  error_collector:
    ignore_messages:
      com.example.MyException:
        - "Some error message to ignore"
        - "Some other error message to ignore"
      com.example.DifferentException:
        - "Some different error message to ignore"

  コピー

  環境変数を使用して、例外クラス名と無視するメッセージを一覧表示できます。

  NEW_RELIC_ERROR_COLLECTOR_IGNORE_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

  コピー

エラーとして扱わないHTTPステータスコードの個別の範囲とダッシュ付きの範囲で構成される、カンマ区切りのリスト。

このプロパティがnewrelic.yml設定ファイルでコメントアウトされている場合、404ステータスコードは自動的に無視されます。サーバー側の設定を使用する場合、無視するにはステータスコード404を指定する必要があります。

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

例えば：

error_collector:
  ignore_status_codes: 404,507-511

指定された例外クラスが、エラーをAPMにレポートする間にエラー率やApdexスコアに影響を与えないようにします。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

例えば：

error_collector:
  expected_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

環境変数を使用して、予想例外クラス名を一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

想定済みとマークされ、エラー率やApdexスコアに影響を与えないようにするための完全修飾例外クラス名と、一致する例外messageのリストで構成される、yamlペアを含みます。後者では、少なくとも1つのメッセージが必要です。例外クラス名がエラーと一致するが、メッセージが一致しない場合、そのエラーは想定済みとマークされず、エラー率やApdexスコアには影響を与えwill not。

メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

例えば：

error_collector:
  expected_messages:
    com.example.MyException:
      - "Some expected error message"
      - "Some other expected error message"
    com.example.DifferentException:
      - "Some different expected error message"

環境変数を使用して、予想例外クラス名とメッセージを一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

想定済みとマークされ、エラー率やApdexスコアに影響を与えない、HTTPステータスコードの個別の範囲とダッシュ付き範囲で構成される、カンマ区切りのリスト。

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

例えば：

error_collector:
  expected_status_codes: 415,500-506

予期されるステータスコードは、NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES環境変数を指定することもできます。

この設定を使用して、トレースエラーのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティがerror_collectorで設定されているかにかかわらず、属性がトレースエラーに送られることはありません。

属性がトレースエラーについて有効になっている場合、このリストにあるすべての属性キーが、トレースされたエラーでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、トレースエラーでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

トランザクションで複数のエラーが検出された場合、デフォルトでは最後のエラーのみがレポートされます。このプロパティをfalseに設定すると、最初に検出されたエラーのみがレポートされます。詳細については、noticeError APIを参照してください。例：

error_collector:
  ignoreErrorPriority: false

指定されたすべての例外クラス名は、エラーとして扱われることはありません。Javaエージェント3.40.0で非推奨となり、ignore_classesで置換されています。

例えば：

error_collector:
  ignore_errors: some.other.MyException