setErrorHandler

構文

newrelic.setErrorHandler(function $callback)

ブラウザ エージェントがキャプチャした既知のエラーを選択的に無視し、グループ化できます。

要件

• Browser Pro または Pro+SPA エージェント (v974 以降)

  • エラーのグループ化機能を使用するには、 v1.230.0以降が必要です。

• npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときにjserrors機能を有効にする必要があります。features配列に以下を追加します。

  import { JSErrors } from '@newrelic/browser-agent/features/jserrors';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      JSErrors
    ]
  }

  コピー

  詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。

説明

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
  }
})