APMエージェントは、サポートされているフレームワークのエラーデータを自動的にレポートします。エラーレポートとアラートを最適化するには、以下のためにさらにエラーを管理できます。
- 当社がデフォルトで計測を行わないエラーを見つける
- レポートされたくないエラーを無視する
- 想定されるエラーからノイズを絞り込んでパフォーマンスに影響を与えるエラーに集中できるようにする（Java、Ruby、Node、Python、および .NET エージェントのみ）
ヒント
3部構成のエラー追跡チュートリアルをご覧ください。このチュートリアルでは、アプリ停止のシナリオ例を使用して、重大なエラーへの対応と解決について説明します。
デフォルトでインストゥルメントされていないエラーを収集する
APMエージェントにはエラーをレポート（または「通知」）するAPIコールが含まれます。これらはAPMがフレームワークを自動でインストゥルメントしないとき、またはサポートされているフレームワークで見つけられない特定のエラーがあるときに役に立ちます。
エラーをレポートするAPMエージェントを取得する方法を学ぶには、エージェント固有のAPIドキュメントを参照してください。
- Go：
NoticeError() - Java：
NoticeError() - .NET：
NoticeError() - Node.js：
noticeError() - PHP：
newrelic_notice_error() - Python：
notice_error() - Ruby：
notice_error()
エラーを無視する
APMエージェントは、ユーザーログインのエラーのような機密情報が含まれるエラーなど、レポートされたくないエラーをインストゥルメントすることがあります。エラーをコレクターにレポートしない場合は、そのエラーを無視することでAPMエージェントはそのエラー全体を破棄します。
ヒント
Java、.NET、Ruby、Node.js、Go、Pythonの場合：エラーをAPMにレポートしたいものの、これらのエラーをApdexまたはエラー率に影響させたくない場合は、想定されるエラーとしてマークを付けます。
エラーを無視するには、エージェント設定またはUIのサーバーサイドコンフィグレーションの2つの方法があります。
予期されるエラー（Java、Node.js、Python、Ruby、Go、.NETのみ）
以下のAPMエージェントの場合は、想定されるエラーとしてマーク付けできます。これらのエラーはAPMにレポートされ、表示されますが、Apdexまたはエラー率（またはエラー率を基にしたアラート条件）には影響しません。
想定されるエラーを設定するには、エージェント特定のドキュメントを参照してください。
想定されるエラーが有効化されている場合、APMのエラー分析ページには、デフォルトでfalseに設定されたerror.expected属性でフィルターが適用されます。これは、想定されるエラーは表示されないことを意味します。想定されるエラーを表示するには、error.expectedフィルターをオフにしてください。
想定されるエラーを表示するには、データのクエリを行います。
- 想定されるエラーのチャートを表示するには、
error.expected属性のクエリを作成します。 - NRQLクエリ用のアラート条件を作成するには、
error.expected属性を使用します。
エラー受信トレイによるフィンガープリント作成エラー
エラー受信トレイは、エラー発生をインテリジェントにグループ化してノイズを減らし、重要なエラーを強調表示します。
エラーイベントが同じフィンガープリントを共有すると、エラーグループにグループ化されます。当社の管理ルールは、定義済みのパターンセットに基づいて自動的にエラーをグループ化できますが、考えられるすべての組み合わせを認識することは不可能です。このため、当社の管理ルールが事象を正確にグループ化していないことが判明した場合、コールバック関数を使用して独自のフィンガープリントを設定することもできます。
カスタムフィンガープリントロジックを設定するには、エージェント固有のマニュアルを参照してください。
UIのエラーを表示
いくつかある場所の中で特に、エラーデータはNew Relic UIの次の部分に表示されます。
- エラー分析ページ：エラーについての詳細なチャートや視覚的分析が表示されます。
- APM概要ページ：お使いのアプリケーションの高度なビューが表示され、それにはエラーが含まれます。
- アラート条件：エラー率に基づく場合があります。
transactionErrorイベント：潜在的なエラーデータを含んでおり、NRQLクエリで使用できます。