Javaエージェントのエラー設定

ハンドリングされないエラー（スタックトレースを含む）

Javaエージェントがトレースしていたトランザクション内で処理されないエラーが発生した場合、そのエラーはフルスタックトレースとともに報告されます。

HTTPステータスコード（スタックトレースなし）

トランザクションの結果としてHTTPステータスコードが発生した場合、スタックトレースを伴わずにエラーが報告されます。これは、以下の理由によるものです。

• アプリケーションサーバーがエラー状態を検出し、ステータスコードを明示的に設定した。

  または

• エラー状態はプログラム・ロジックによって検出されたため、例外オブジェクトやスタックはありませんでした。

  これらのタイプのトランザクションにスタックトレースを含めるためには、 noticeError(...) APIコールを使用する必要があります。

noticeError(...) APIコール

Javaエージェントが noticeError(...) APIコールを使って明示的に呼び出した場合、エラーがトランザクション内で発生したかどうかに関わらず、エラーが報告されます。報告される情報は、 noticeError(...) APIコールで使用されるパラメータに依存し、その内容は、 Javadocs で説明されています。

100%以上の未処理エラー報告

Javaエージェントは、どのトランザクションにも結びつかないエラーである、スコープ外のエラーを報告することができます。このため、1つのタイムスライスに1つのトランザクションがあり、同じタイムスライスに複数のエラーが発生する可能性があります。このような状況では、New Relic はエラー率 が 100% を超えて表示されます。.

UIによるエラーの設定

サーバーサイドコンフィグ によって、エラーを無視したり、期待通りのマークを付けたりすることができます。

Configure as expected errors via newrelic.yml.

これらのバージョンで報告されるエラー noticeError は、 expected errors in the newrelic.yml として設定することができます。 newrelic.yml で ignored としてエラーが設定されている場合、このAPIへの呼び出しは上書きされます。詳しくは、 Error configuration precedence をご覧ください。

これらの noticeError() API コールを使用して、自動的に報告されないエラーを報告し、 expected errors として newrelic.yml に設定します。

• noticeError(String message)

  コピー

• noticeError(String message, Map<String, String> params)

  コピー

• noticeError(Throwable throwable)

  コピー

• noticeError(Throwable throwable, Map<String, String> params)

  コピー

Override expected errors via newrelic.yml.

これらのバージョンで報告されるエラー noticeError は、 newrelic.yml expected error の設定を上書きします。yml でエラーが ignored として設定されている場合、この API の呼び出しは上書きされます。詳細は、 Error configuration precedence を参照してください。

これらの noticeError(...) API コールを使用して、自動的に報告されないエラーを報告し、それらを 期待されるエラー として API で設定します（yml の期待されるエラー設定をオーバーライドします）。

• noticeError(String message, boolean expected)

  コピー

• noticeError(String message, Map<String, String> params, boolean expected)

  コピー

• noticeError(Throwable throwable, boolean expected)

  コピー

• noticeError(Throwable throwable, Map<String, String> params, boolean expected)

  コピー

設定ファイルによるエラーを無視するか期待するか。

バージョン3.40.0以降では、 YAMLベースの設定 を使用して、エラーの報告方法を制御することができます。これにより、エラーを無視するか、HTTPステータスコードに基づくエラーを期待するか または、例外クラス名のリストとオプションのエラーメッセージに基づく が可能です。

• Ignoring errors 指定された例外クラスまたはコードがAPMにまったく報告されないようにします。

• Expecting errors 指定された例外クラスやコードが、アプリケーションの エラーレート や Apdex score に影響を与えることを防ぎます。これにより、トラブルシューティングのためにエラー情報を保持しつつ、エラーレートやApdexスコアに基づくアラートを回避することができます。

  これらの設定は動的なものなので、実行中のエージェントは、JVMを再起動しなくても newrelic.yml の変更に気づくことができます。詳細と例については、 Javaエージェント設定ファイル を参照してください。