APMのJavaエージェントは、アプリケーション内で発生したエラーの詳細情報をレポートします。これにより、アプリケーションのパフォーマンスやエンドユーザーの体験に影響を与えている可能性のある問題領域を把握することができます。
Java エージェント バージョン 3.40.0 以降 では、エラーの報告方法を制御するための設定オプションがいくつかあります。
予想されるエラーがエラーレートやApdexに影響を与えないように設定する エラーの無視 自動的に報告されないエラーを報告する エラーデータの表示については、 Error analytics を参照してください。すべてのエージェントのエラーデータの概要については、 Manage errors in APM を参照してください。
一般的に報告されているエラー例 次のような場合に、Javaエージェントでエラーが発生することがありました。
エラー報告
コメントコメント
ハンドリングされないエラー（スタックトレースを含む）
Javaエージェントがトレースしていたトランザクション内で処理されないエラーが発生した場合、そのエラーはフルスタックトレースとともに報告されます。
HTTPステータスコード（スタックトレースなし）
トランザクションの結果としてHTTPステータスコードが発生した場合、スタックトレースを伴わずにエラーが報告されます。これは、以下の理由によるものです。
アプリケーションサーバーがエラー状態を検出し、ステータスコードを明示的に設定した。
また
エラー状態はプログラム・ロジックによって検出されたため、例外オブジェクトやスタックはありませんでした。
これらのタイプのトランザクションにスタック トレースを含めるには、 noticeError(...) API 呼び出しを使用する必要があります。
noticeError(...) APIコール
Java エージェントがnoticeError(...) API 呼び出しを使用して明示的な呼び出しを行った場合、トランザクション内で発生したかどうかに関係なく、エラーが報告されます。報告される情報は、 Javadocs で説明されているように、 noticeError(...) API 呼び出しで使用されるパラメーターによって異なります。
100%以上の未処理エラー報告
Javaエージェントは、どのトランザクションにも結びつかないエラーである、スコープ外のエラーを報告することができます。このため、1つのタイムスライスに1つのトランザクションがあり、同じタイムスライスに複数のエラーが発生する可能性があります。このような状況では、New Relic はエラー率 が 100% を超えて表示されます。 .
エラーレポートの設定 Javaエージェントには、エラーの報告方法を制御するための柔軟な設定オプションがいくつか用意されています。
設定オプション
詳細
UIによるエラーの設定
サーバーサイドコンフィグ によって、エラーを無視したり、期待通りのマークを付けたりすることができます。
newrelic.ymlを介して予期されるエラーを構成します。
これらのバージョンのnoticeErrorによって報告されるエラーは、 newrelic.ymlで予想されるエラー として構成できます。エラーがnewrelic.ymlで無視さ れるように構成されている場合、この API の呼び出しはオーバーライドされます。詳細については、 エラー構成の優先順位 を参照してください。
これらのnoticeError() API 呼び出しを使用して、自動的に報告されないエラーを報告し、それらをnewrelic.ymlで予想されるエラー として構成します:
newrelic.ymlを介して予想されるエラーをオーバーライドします。
noticeErrorのこれらのバージョンによって報告されたエラーは、 newrelic.ymlの予想されるエラー 構成をオーバーライドします。エラーが yml で無視さ れるように構成されている場合、この API の呼び出しはオーバーライドされます。詳細については、 エラー構成の優先順位 を参照してください。
これらのnoticeError(...) API 呼び出しを使用して、自動的に報告されないエラーを報告し、API で予期されるエラー として構成します (yml の予期されるエラー構成をオーバーライドします)。
設定ファイルによるエラーを無視するか期待するか。
バージョン3.40.0以降では、 YAMLベースの設定 を使用して、エラーの報告方法を制御することができます。これにより、エラーを無視するか、HTTPステータスコードに基づくエラーを期待するか または、例外クラス名のリストとオプションのエラーメッセージに基づく が可能です。
エラーを無視すると、 指定された例外クラスまたはコードが報告されなくなります APM まったく。
Expecting errors 指定された例外クラスやコードが、アプリケーションの エラーレート や Apdex score に影響を与えることを防ぎます。これにより、トラブルシューティングのためにエラー情報を保持しつつ、エラーレートやApdexスコアに基づくアラートを回避することができます。
これらの設定は動的なものなので、実行中のエージェントは、JVMを再起動しなくても newrelic.yml の変更に気づくことができます。詳細と例については、 Javaエージェント設定ファイル を参照してください。
エラー収集のためのYAMLベースの設定 YAMLベースのエラーコレクションの設定では、特定のエラーを完全に無視したり、予想されるエラーを除外して、アプリケーションのエラーレートやApadexスコアに影響を与えないようにすることができます。以下の基準に基づいて、エラーを無視または予期されるものとしてマークすることができます。
HTTPステータスコードの指定された範囲を、カンマで区切られたリストまたは破線の範囲として表示します。 パッケージ/クラスの完全修飾名を使用したコンマ区切りのリスト および 任意で提供されるエラーメッセージ文字列 エラー収集の有効化 デフォルトでは、Java エージェントには、すべてのYAML ベースのエラー構成 オプションが含まれるerror_collectorセクションが含まれています。 エラー収集は次のように有効または無効にできます。
特定のエラーを無視する 特に興味のないエラーは完全に無視することができます。無視すべきエラーを特定することで
予想されるエラーがエラーレートやApdexに影響することを防ぐ アプリケーションのビジネスロジックの一部として 予想される エラーは、エラーレートやApdexスコアに影響を与えないようにしても、APMに報告されます。これにより、トラブルシューティングのためにUIにエラー情報を残しつつ、これらのエラーに起因するアラート（エラーレートやApdexスコアに基づく）を回避することができます。
以下は、 YAMLベースの設定 予想されるエラーに対するオプションを示す例です。
- "com.example.ExpectedErrorClass"
com.example.OtherExpectedErrorClass :
- "some expected error message"
expected_status_codes : 406 , 500 - 504
エラー設定の優先順位 エラー設定の優先順位は
サーバー側の設定 (YAMLファイルに値を重ねる)ignore_* YAML の構成expected noticeError(..) API 呼び出しのパラメーターexpected_* YAML の構成ここでは、さまざまなAPIコールとYAMLの設定を組み合わせた場合の結果の例を紹介します。
エラークラスを無視する（YAMLはAPIをオーバーライドする） YAMLの設定です。
- "com.example.ErrorClass"
および
APIコールです。
noticeError ( com . example . ErrorClass )
結果。
YAML ignore_classesはnoticeError API 呼び出しをオーバーライドし、エラーは無視されます。
予想されるエラーの報告（YAMLおよびAPI） YAMLの設定です。
- "com.example.ErrorClass"
と
APIコールです。
noticeError ( com . newrelic . Exception )
結果。
noticeError API 呼び出しのexpectedパラメータはデフォルトで true であり、YAML expected_classes構成にはエラー クラスが含まれています。したがって、エラーが報告され、 expectedとしてマークされます。
予想されるエラーの報告（YAMLなし） YAML設定なし
と
APIコールです。
noticeError ( com . newrelic . Exception , expected = true )
結果。
エラーが報告され、期待通りのマークが表示されます。
YAML ignore_classes は API の期待されるパラメータをオーバーライドします。 YAMLの設定です。
- "com.example.ErrorClass"
と
APIコールです。
noticeError ( com . newrelic . Exception , expected = true )
結果。
YAML ignore_classesはnoticeError API 呼び出しのexpectedパラメータをオーバーライドするため、エラーは無視されます。
APIの期待されるパラメータはYAMLの expected_classesをオーバーライドします。 YAMLの設定です。
- "com.example.ErrorClass"
と
APIコールです。
noticeError ( com . newrelic . Exception , expected = false )
結果。
noticeError API 呼び出しのexpectedパラメータは、YAML のexpected_classesをオーバーライドします。したがって、エラーは通常どおり報告されます ( expectedとしてマークされません)。
YAMLで期待されるオーバーライドを無視する YAMLの設定です。
- "com.example.ErrorClass"
と
YAMLの追加設定
- "com.example.ErrorClass"
結果。
YAML ignore_classes/ignore_messagesは YAML expected_classes/expected_messagesをオーバーライドするため、エラーは無視されます。これと同じ原則がignore_status_codesとexpected_status_codesに適用されます。
エラーの詳細についてログを調べる ログやアプリケーションのデータをまとめて、トラブルシューティングを簡単かつ迅速に行うことができます。 logs in context では、エラーやトレースに関連するログメッセージをアプリのUIで直接確認することができます。
Errors ページから、トレースをクリックして Error details ページエラー詳細ページで、See logs をクリックします。 個々のログメッセージに関連する詳細を表示するには、メッセージを直接クリックします。 無視されるエラーと期待されるエラーをUIで設定 APM UIを介して、 予想されるエラー を設定すること。
有効になっていない場合は、サーバーサイドコンフィグレーションを有効化 します。 期待通りとマークしたいエラーのあるアプリケーションのサーバー側の設定メニュー にアクセスします。エラーコレクション の下で、 Ignore または Exclude expected errors のいずれかに、設定したいエラーの HTTP コードまたはエラークラスを入力します。Select Save . 予想されるエラーをUIで表示する方法については、 予想されるエラーを表示する を参照してください。