カスタムグループ化

概要

エラー追跡は、デフォルトの戦略を使って、類似のエラーを問題としてインテリジェントにグループ化します。_カスタムフィンガープリンティング_を使えば、グループ化の決定を完全に制御し、リアルユーザーモニタリング (RUM) エラーに対するグループ化の動作をカスタマイズすることができます。

エラー追跡が RUM エラーを問題としてグループ化する際に使用できるerror.fingerprint 属性を指定してください。 error.fingerprint 属性の値について特に形式や要件はありませんが、その中身は文字列でなければなりません。

error.fingerprint が指定されている場合、グループ化の動作は次のルールに従います。

  • カスタムグループ化がデフォルトの戦略よりも優先されます。
  • カスタムグループ化は RUM エラーのサブセットにのみ適用可能で、デフォルトの戦略と共存できます。
  • error.fingerprint の内容は、修正なしでそのまま使用されます。
  • 同じサービスで発生し、同じ error.fingerprint 属性を持つ RUM エラーは、同じ問題としてグループ化されます。
  • service 属性が異なる RUM エラーは、別の問題としてグループ化されます。

ブラウザエラーの設定

カスタマイズグループ化を使用するには、Datadog ブラウザ SDK v4.42.0 以降、ブラウザ RUM エラー、および追加文字列属性が必要です。

まだ Datadog でブラウザ RUM イベントを収集していない場合は、ブラウザモニタリングのセットアップドキュメントを参照してください。

例

すでにブラウザエラーを収集している場合は、以下のどちらかで属性を追加することが可能です。

  • エラーオブジェクトに dd_fingerprint 属性を追加する。
import { datadogRum } from '@datadog/browser-rum';
// カスタムエラーをコンテキスト付きで送信する
const error = new Error('Something went wrong');
error.dd_fingerprint = 'my-custom-grouping-fingerprint'
datadogRum.addError(error);
  • または、beforeSend コールバックに error.fingerprint 属性を付けて使用する。
DD_RUM.init({
  ...
  beforeSend: () => {
    if (event.type === 'error') {
      event.error.fingerprint = 'my-custom-grouping-fingerprint'
    }
  },
})

どちらの場合も、my-custom-grouping-material を使用して、エラー追跡でブラウザ RUM エラーを 1 つの問題にグループ化します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

datadog-ci ソースコードGITHUB more more JavaScript ソースマップのアップロードDOCUMENTATION more more Web アプリケーションとモバイルアプリケーションのエラー追跡についてDOCUMENTATION more more