RUM イベントからカスタムメトリクスを生成する

概要

Real User Monitoring (RUM) では、Datadog RUM SDK を使用してブラウザやモバイルアプリケーションで発生するイベントをキャプチャし、サンプルレートでイベントからデータを収集することが可能です。Datadog は、このイベントデータを RUM エクスプローラーに保持し、検索クエリや視覚化を作成することができます。

RUM ベースのカスタムメトリクスは、RUM イベントのセットからデータを要約するためのコスト効率の良いオプションです。最大 15 か月間の RUM データの傾向や異常を詳細に視覚化することができます。

請求について: RUM イベントから生成されたメトリクスは、カスタムメトリクスとして請求されます。

RUM ベースのカスタムメトリクスを作成する

RUM イベントデータからカスタムメトリクスを作成するには、UX Monitoring > Setup & Configuration > Generate Metrics に移動して + New Metric をクリックします。

RUM ベースのカスタムメトリクスを作成するには、+ New Metric をクリックします

RUM エクスプローラーで検索クエリからカスタムメトリクスを作成するには、Export ボタンをクリックし、ドロップダウンメニューから Generate new metric を選択します。

RUM ベースのカスタムメトリクスを生成する
  1. カスタムメトリクスには、datadog.estimated_usage で始まらない名前、例えば rum.sessions.count_by_geography を付けてください。詳しくは、命名規則を参照してください。

  2. カスタムメトリクスを作成したいイベントタイプを選択します (例: Sessions)。オプションには、SessionsViewsActionsErrorsResourcesLong Tasks があります。詳細については、RUM イベントの検索を参照してください。

  3. RUM エクスプローラーの検索構文 (例: @session.type:user) を使用して、RUM イベントをフィルタリングする検索クエリを作成します。

  4. Count の隣にあるドロップダウンメニューから、追跡するフィールドを選択します。

    • * を選択すると、検索クエリに一致するすべての RUM イベントのカウントが生成されます。
    • オプションで、@action.target のようなイベント属性を入力すると、数値を集計して、対応する count または distribution メトリクスが作成されます。

    RUM 属性ファセットがメジャーの場合、メトリクス値は RUM 属性値です。

  5. グループ化するパスを group by の横のドロップダウンメニューから選択します。メトリクスのタグ名は、元の属性またはタグ名から @ を除いたものです。デフォルトでは、RUM イベントから生成されたカスタムメトリクスには、明示的に追加されない限りタグは含まれません。RUM イベントに存在する @error.sourceenv などの属性またはタグのディメンションを使用して、メトリクスタグを作成することができます。

    RUM-based custom metrics are considered as custom metrics and billed accordingly. Avoid grouping by unbounded or extremely high cardinality attributes such as timestamps, user IDs, request IDs, and session IDs.
  6. セッションとビューで作成されたカスタムメトリクスの場合、セッションとビューのマッチング基準を設定するために、The active session/view starts matching the query (アクティブなセッション/ビューがクエリにマッチし始める) または The session/view becomes inactive or is completed (セッション/ビューが非アクティブになるか完了する) を選択します。詳細については、セッションとビューに RUM ベースのメトリクスを追加するを参照してください。

  7. ディストリビューションメトリクスにパーセンタイル集計を追加しました。高度なクエリ機能をオプトインし、グローバルに正確なパーセンタイル (P50、P75、P90、P95、P99 など) を使用することができます。

    パーセンタイルによる高度なクエリ機能を有効にすると、より多くのカスタムメトリクスが生成され、それに応じて請求が行われます
  8. Create Metric をクリックします。

RUM ベースのカスタムメトリクスが Custom RUM Metrics の下のリストに表示され、メトリクスがダッシュボードモニターで利用可能になるまで少し時間がかかる場合があります。

履歴データのあるメトリクスでは、データポイントは作成されません。RUM ベースのカスタムメトリクスのデータポイントは 10 秒間隔で生成されます。メトリクスのデータは 15 か月間保持されます。

セッションとビューに関する RUM ベースのメトリクスを追加する

セッションとビューは、RUM アプリケーションで継続的なアプリケーションまたはユーザーのアクティビティがある場合にアクティブと見なされます。たとえば、ユーザーが新しいページを開くと、これらのページビューはユーザーセッションに収集されます。ユーザーがページ上のボタンを操作すると、これらのアクションはページビューに収集されます。

5 つ以上のエラーを含むユーザーセッションの数をカウントする RUM ベースのカスタムメトリクスがあり、午前 11 時に 5 つのエラーに達し、午後 12 時に終了するセッション ID 123 があると仮定しましょう。

  • セッションまたはビューがクエリに一致するとすぐに考慮することで、午前 11 時のタイムスタンプでカウントメトリクスの値を 1 増やします。
  • 非アクティブなセッションまたはビューを考慮することで、午後 12 時のタイムスタンプでカウントメトリクスの値を 1 増やします。

RUM ベースのカスタムメトリクスを管理する

また、クエリに一致する RUM イベントのカウントメトリクスや、リクエスト期間など RUM イベントに含まれる数値のディストリビューションメトリクスを生成することが可能です。

RUM ベースのカスタムメトリクスを更新する

メトリクスを更新するには、メトリクスの上にカーソルを置き、右側の Edit アイコンをクリックします。

  • フィルタークエリ: メトリクスに集計される、一致する RUM イベントのセットを変更します。
  • 集計グループ: タグを更新して、生成されたメトリクスのカーディナリティを管理します。
  • パーセンタイル選択: パーセンタイルメトリクスを削除または生成するには、Calculate percentiles トグルをクリックします。

既存のメトリクスは名前を変更できないため、Datadog では別のメトリクスの作成を推奨しています。

RUM ベースのカスタムメトリクスを削除する

カスタムメトリクスと請求からデータポイントの計算を停止するには、メトリクスにカーソルを合わせ、右側の Delete アイコンをクリックします。

使用方法

RUM ベースのカスタムメトリクスは、以下のアクションに使用できます。

  • ダッシュボードで一定期間のトレンドを視覚化する
  • 異常モニターで、メトリクスが過去と異なる挙動を示した場合にアラートをトリガーする
  • 予測モニターで、あるメトリクスが将来的にしきい値を超えると予測された場合にアラートをトリガーする
  • メトリクスベースの SLO を作成し、チームや組織のユーザー中心のパフォーマンス目標を追跡する

その他の参考資料