重要
この API を使用するには、ブラウザ エージェントの Browser Pro または Pro+SPA エディションが必要です。
構文
newrelic.setErrorHandler(function $callback)
ブラウザ エージェントがキャプチャした既知のエラーを選択的に無視し、グループ化できます。
要件
エージェントのバージョン nr-974 以上。
エラーのグループ化機能には、バージョン 1.230.0 以降が必要です。
説明
newrelic.setErrorHandler()
API 呼び出しを使用すると、ブラウザ エージェントがキャプチャした既知のエラーを選択的に無視できます。ブラウザー エージェントがキャプチャするエラーごとに呼び出される単一のエラー ハンドラー関数を使用します。ハンドラーがtrue
を返す場合、New Relic はエラーを記録しません。それ以外の場合、エラーは通常どおり処理されます。
さらに、エージェントの新しいバージョンでは、フィンガープリントまたはカスタム提供ラベルによる例外のグループ化がサポートされています。これを行うには、 group
プロパティが目的の 文字列に設定されたブール値の代わりにオブジェクトを返します。空の文字列、またはこの正確な仕様に準拠しないオブジェクトを指定すると、エラーが 無視される true
の場合と同じように扱われることに注意してください。この動作は、以前のバージョンと下位互換性があります。
パラメーター
パラメータ | 説明 |
---|---|
機能 | 必須. エラーが発生すると、エラーオブジェクトをパラメータとして、コールバックが呼び出されます。コールバックは、エラーが発生するたびに呼び出されるので、ひとつのエラーに特化したものではありません。 |
例
基本的なエラー ハンドラー関数を使用する
ブラウザエージェントが捕捉した特定のエラーを無視するには、コールバック関数の内部にエラーオブジェクトを含めます。
newrelic.setErrorHandler(function(err) { if (shouldIgnoreError(err)) { return true; } else { return false; }});
ハンドラー関数のフィンガープリント エラー
カスタム ラベルを特定のエラーに割り当てて、エラー インボックス UI に表示します。
newrelic.setErrorHandler(function(err) { if (isReferenceError(err)) { return { group: 'My reference errors' }; // error is included and tagged under this label } else if (isSomeSpecificError(err)) { return { group: '' }; // error will be excluded! // return { Group: 'still excluded - prop name has capital G!' }; } else { return false; // error is included without any label }})