エラーと例外

AppDynamicsアプリケーションインテリジェンスプラットフォームは、監視対象環境内におけるビジネストランザクションエラーに関する情報を取得し提示します。

上位レベルでは、指定したメソッドに基づくカスタムエラーイベントなど、コードレベルの例外またはエラーイベントにより通常の処理が影響を受けた場合に、ビジネストランザクションでエラーが発生したとみなされます。

エラーと例外に関する情報の表示

コントローラUIには、トランザクションスナップショット、メトリック、およびダッシュボードなど、UIのさまざまな場所のエラーおよび例外に関する情報が表示されます。

フローマップ内のティアに関する情報ポップアップには、そのティアのエラー率メトリックを表示するエラータブが含まれています。

Error Rate Metrics

アプリケーションおよびティアフローマップでは、エラー率はすべてのビジネストランザクションを対象としています。ビジネストランザクションフローマップでは、エラーは現在のビジネストランザクションのみを対象としています。

メトリックブラウザには Error メトリックが含まれています。

Metric Browser

[Troubleshoot] > [Errors] ページにはすべてのエラートランザクションが表示されます。このページには、トランザクションエラーと例外の2つのタブがあります。

これらのタブには、エラーまたは例外の割合に関する情報が表示され、下図に示すようにエラーまたは例外にドリルダウンして詳細情報を確認できます。

Exceptions

ビジネストランザクションエラー

構成済みのエラー検出ルールに従ってコントローラ UI の選択した時間内で検出されたすべてのトランザクションエラーは、[Errors] ページの [Error Transactions] タブに表示されます。

デフォルトで、AppDynamics では、トランザクションのコンテキストで以下のいずれかのタイプのイベントが検出された場合に、ビジネストランザクションがエラーであるとみなされます。

未処理の例外またはエラー。発生した後キャッチされなかった例外や、ビジネストランザクションの終了後にキャッチされた例外は、トランザクションエラーとなり、AppDynamics に表示されます。ビジネストランザクションのコンテキスト内で発生しキャッチされた例外はトランザクションエラーとはみなされず、AppDynamics でキャプチャされません。
Web サービスやデータベースコールなどの終了コールでキャッチされた例外。
ステータスコード404または500の応答などのHTTPエラー応答。
カスタム構成のエラーメソッドおよびエラーメッセージ。

エラー検出の構成については、「エラー検出」で説明されています。

ダウンストリームティアで発生し、発生元のティアに伝播されないエラーはビジネストランザクションエラーにはなりません。たとえば、発生元のクライアントが 200 Success 応答を受信した場合、ビジネストランザクションはエラーとみなされません。ダウンストリームティアに含まれるエラーは、継続するセグメントの「1 分あたりのエラー数」メトリックにはカウントされます。

ビジネストランザクションにエラーが発生した場合、エラートランザクションとしてのみカウントされます。トランザクションが遅延または停滞していた場合でも、遅い、非常に遅い、または停滞するトランザクションとしてカウントされません。

AppDynamics のコード例外

ビジネストランザクションエラーの一般的な原因はコードの例外です。[Errors] ページの [Exceptions] タブには、すべてのトランザクションの例外を集約したビューが表示されます。このビューの目的上、AppDynamics は以下のインシデントを例外とみなします。

重要度が Error または Fatal である例外（Log4j、java.util.logging、Log4Net/NLog、サポートされているその他のロガーを使用する場合）。これは、ビジネストランザクションのコンテキスト外で発生した場合にも適用され、例外タイプは Application Server であると指定されます。
ビジネストランザクションのコンテキストでは発生しないHTTPエラー。
エラーページのリダイレクト。

ビジネストランザクション内で発生し処理される例外については、AppDynamics はキャプチャせず、[Exceptions] タブにも表示されません。

エラーをトラブルシューティングする際には、ビジネストランザクションエラーの数が必ずしも特定の時間帯における例外数に対応するとは限りません。エラートランザクションとしてカウントされる単一のトランザクションは、複数の例外に対応する可能性があります。たとえば、トランザクションがティアを横断している場合には、それぞれで例外が生成される可能性があります。通常、エラーのトラブルシューティングを行うには、エラーの起点に最も近い例外を見つける必要があります。

例外のスタックトレースが利用可能な場合は、コントローラ UI の [Exception] タブからアクセスできます。ログをコールする際に例外を渡した場合、その例外に対するスタックトレースを使用できます。たとえば logger.log(Level.ERROR, String msg, Throwable e) 形式でログをコールした場合はスタックトレースが含まれますが、logger.log(Level.ERROR, String msg) 形式のコールでは含まれません。

エージェントのエラー

Javaエージェントでは、エージェントの内部エラーとアプリケーションエラーが区別されます。デフォルトでは、エージェントの内部エラーによって正常性ルール違反が発生することはありません。エージェントの内部エラーは、メトリックブラウザの次のパスで確認できます。Application Infrastructure Performance > <tier> > Agent > Internal Errors