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