APMエージェントはサポートされているフレームワークのエラーデータを自動的にレポートします。エラーレポートとアラートを最適化するには、以下のためにさらにエラーを管理できます。
- 当社がデフォルトで計測を行わないエラーを見つける 。
- レポートされたくないエラーを無視する。
- 想定されるエラーからノイズを絞り込んでパフォーマンスに影響を与えるエラーに集中できるようにします。(Javaエージェント、Rubyエージェント、Nodeエージェント、Pythonエージェント、.NETエージェントのみ)
デフォルトでインストゥルメントされていないエラーを収集する
APMエージェントにはエラーをレポート(または「通知」)するAPIコールが含まれます。これらはAPMがフレームワークを自動でインストゥルメントしないとき、またはサポートされているフレームワークで見つけられない特定のエラーがあるときに役に立ちます。
エラーをレポートするAPMエージェントを取得する方法を学ぶには、エージェント固有のAPIドキュメントを参照してください。
- C SDK:
newrelic_notice_error()
- Go:
NoticeError()
- Java:
NoticeError()
- .NET:
NoticeError()
- Node.js:
noticeError()
- PHP:
newrelic_notice_error()
- Python:
notice_error()
- Ruby:
notice_error()
エラーを無視する
APMエージェントは、ユーザーログインのエラーのような機密情報が含まれるエラーなど、レポートされたくないエラーをインストゥルメントすることがあります。エラーをコレクターにレポートしない場合は、そのエラーを無視することでAPMエージェントはそのエラー全体を破棄します。
ヒント
エラーをAPMにレポートしたいが、これらのエラーをApdexまたはエラー率に影響させたくない場合は、想定されるエラーとしてマークを付けます。
エラーを無視するには、エージェント設定またはUIのサーバーサイドコンフィグレーションの2つの方法があります。
予期されるエラー(Java、Node.js、Python、Ruby、.NETのみ)
以下のAPMエージェントの場合は、想定されるエラーとしてマーク付けできます。これらのエラーはAPMにレポートされ、表示されますが、Apdexまたはエラー率(またはエラー率を基にしたアラート条件)には影響しません。
想定されるエラーを設定するには、エージェント特定のドキュメントを参照してください。
想定されるエラーが有効化されている場合、APMのエラー分析ページには、デフォルトでfalse
に設定されたerror.expected
属性でフィルターが適用されます。これは、想定されるエラーは表示されないことを意味します。想定されるエラーを表示するには、error.expected
フィルターをオフにしてください。
想定されるエラーを表示するには、データのクエリを行います。
- 想定されるエラーのチャートを表示するには、
error.expected
属性のクエリを作成します。 - NRQLクエリ用のアラート条件を作成するには、
error.expected
属性を使用します。
UIのエラーを表示
いくつかある場所の中で特に、エラーデータはNew Relic UIの次の部分に表示されます。
- エラー分析ページ:エラーについての詳細なチャートや視覚的分析が表示されます。
- APM概要ページ:お使いのアプリケーションの高度なビューが表示され、それにはエラーが含まれます。
- アラート条件:エラー率に基づく場合があります。
transactionError
イベント:潜在的なエラーデータを含んでおり、NRQLクエリで使用できます。