APMのエラーを管理する:想定通りに収集、無視、またはマークを付ける

APMエージェントはサポートされたフレームワークのエラーデータを自動的にレポートします。エラーレポートとアラートを最適化するには、以下のためにさらにエラーを管理できます。

  • 当社がデフォルトで計測を行わないエラーを見つける
  • レポートされたくないエラーを無視する
  • 想定されるエラーからノイズを絞り込んでパフォーマンスに影響を与えるエラーに集中できるようにします。(JavaエージェントとRubyエージェント、Nodeエージェント、.NETエージェントのみ)

デフォルトでインストゥルメントされていないエラーを収集する

APMエージェントにはエラーをレポート(または「通知する」)APIコールが含まれます。これらはAPMがフレームワークを自動でインストゥルメントしないときや、サポートされているフレームワークで見つけられない特定のエラーがあるときに役に立ちます。

エラーをレポートするAPMエージェントを取得する方法を学ぶには、エージェント固有のAPIドキュメントを参照してください。

エラーを無視する

APMエージェントはユーザーログインのエラーのような機密情報が含まれるエラーなど、レポートされたくないエラーをインストゥルメントすることがあります。エラーをコレクターにレポートしない場合は、そのエラーを無視することでAPMエージェントはそのエラー全体を破棄します。

Java、Ruby、Node.jsの場合:エラーをAPMにレポートしたいが、これらのエラーをApdexまたはエラー率に影響させたくない場合は、想定されるエラーとしてマークを付けます。

エラーを無視するには次の2通りの方法があります。エージェント設定を通して、または次のUIのサーバーサイドコンフィグレーションを通して実行します。

UIのサーバーサイドコンフィグレーションを使ってエラーを無視する

このオプションが利用できるかは、エージェントがサーバーサイドコンフィグレーションに対応しているかどうかによります。

  1. すでに有効になっていなければ、サーバーサイドコンフィグレーションを有効にします。
  2. 無視したいエラーがあるアプリケーションのServer-side configurationメニューに移動します
  3. Error collectionの下で、Ignore from error collectionを検索します。無視したいエラーのHTTPコードまたはErrorクラスを追加します。
  4. Save server-side configurationを選択します。
エージェント設定を使ってエラーを無視する

エージェント設定を使ってエラーを無視するには、お使いのエージェントの設定向けのドキュメントを参照してください。

想定されるエラー(JavaおよびNode.js、Ruby、.NETのみ)

RubyエージェントおよびJavaエージェントの場合は、想定されるエラーとしてマークを付けることができます。これらのエラーはAPMにレポートされ、表示されますが、Apdexまたはエラー率(またはエラー率を基にしたアラート条件)には影響しません。

想定されるエラーを設定するには、エージェント固有のドキュメントを参照してください:

想定されるエラーが有効化されている場合、APMのError analytics(エラー分析)ページには、デフォルトでfalseに設定されたerror.expected属性でフィルターが適用されます。これは、想定されるエラーが表示されないことを意味します。予想されるエラーを表示するには、error.expectedフィルターをオフにしてください。

想定されるエラーを表示するには、データのクエリを行います:

UIのエラーを表示

その他に、エラーデータはNew Relic UIの次の部分に表示されます。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください: