ページのパフォーマンスの監視

機能フラグ追跡のベータ版に参加しよう！

機能フラグで RUM データを補強し、パフォーマンス監視を可視化。機能フラグ追跡は非公開ベータ版です。アクセス権をリクエストするには、Datadog サポート (support@datadoghq.com) までご連絡ください。

概要

RUM のビューイベントは、すべてのページビューについて、広範なパフォーマンスメトリクスを収集します。アプリケーションのページビューを監視し、ダッシュボードや RUM エクスプローラでパフォーマンスメトリクスを確認することができます。

RUM エクスプローラーの RUM ビューの Performance タブに表示されるウォーターフォールグラフ

以下で、ビューのパフォーマンスメトリクスにアクセスできます。

すぐに使える RUM ダッシュボード。これは、アプリケーションのパフォーマンスの概要を表示するものです。例えば、RUM が収集したデフォルト属性にフィルターをかけて、パフォーマンス概要ダッシュボードでユーザーのサブセットに影響を与える問題を浮き彫りにすることができます。また、このダッシュボードを複製してニーズに合わせてカスタマイズし、ダッシュボードのクエリで任意の RUM パフォーマンスメトリクスを使用することができます。
RUM エクスプローラーの各 RUM ビューイベントでアクセスできるパフォーマンスウォーターフォール。ここでは、特定のページビューのパフォーマンスのトラブルシューティングを行うことが可能です。Web サイトのアセットやリソース、ロングタスク、フロントエンドエラーが、エンドユーザーのページレベルのパフォーマンスにどのような影響を与えるかが表示されます。

イベントのタイミングとコア Web バイタル

Datadog の Core Web Vitals メトリクスは、@datadog/browser-rum パッケージ v2.2.0 以降から入手できます。

Google のウェブに関する主な指標は、サイトのユーザーエクスペリエンスを監視するために設計された 3 つのメトリクスのセットです。これらのメトリクスは、負荷パフォーマンス、対話性、視覚的安定性のビューを提供することに重点を置いています。各メトリクスには、優れたユーザーエクスペリエンスにつながる値の範囲に関するガイダンスが付属しています。Datadog では、このメトリクスの 75 パーセンタイルの監視をおすすめしています。

バックグラウンドで開かれたページの First Input Delay および Largest Contentful Paint は収集されません（たとえば、新規タブや焦点のないウィンドウ）。
実際のユーザーのページビューから収集されたメトリクスは、Synthetic ブラウザテストなどの固定され制御された環境で読み込まれたページに対して計算されたものと異なる場合があります。Synthetic Monitoring では、Largest Contentful Paint と Cumulative Layout Shift は、実際のメトリクスではなく、ラボのメトリクスとして表示されます。

メトリクス	焦点	説明	対象値
Largest Contentful Paint	ロードパフォーマンス	ビューポート内の最大の DOM オブジェクト (つまり、画面に表示される) がレンダリングされるページ読み込みタイムラインの瞬間。	2.5秒以下
First Input Delay	インタラクティブなアクティビティ	ユーザーがページを最初に操作してからブラウザが応答するまでの経過時間。	100ms以下
Cumulative Layout Shift	ビジュアルの安定性	動的に読み込まれるコンテンツ (サードパーティの広告など) による予期しないページ移動を定量化します。0 はシフトが発生していないことを意味します。	0.1以下

すべてのパフォーマンスメトリクス

属性	タイプ	説明
`view.time_spent`	数値（ns）	現在のビューに費やした時間。
`view.first_byte`	数値（ns）	ビューの 1 バイト目を受信した時点までの経過時間。
`view.largest_contentful_paint`	数値（ns）	ページロードのタイムラインで、ビューポートで最大の DOM オブジェクトがレンダリングされ、画面上に表示された瞬間。
`view.first_input_delay`	数値（ns）	ユーザーがページを最初に操作してからブラウザが応答するまでの経過時間。
`view.cumulative_layout_shift`	数値	動的に読み込まれるコンテンツ (サードパーティの広告など) による予期しないページ移動を定量化します。0 はシフトが発生しないことを意味します。
`view.loading_time`	数値（ns）	ページの準備が整い、ネットワークリクエストまたは DOM ミューテーションが現在発生していない状態になるまでの時間。詳しくはページパフォーマンスの監視をご覧ください。
`view.first_contentful_paint`	数値（ns）	ブラウザによりテキスト、画像（背景画像を含む）、白以外のキャンバス、または SVG が最初にレンダリングする時間。ブラウザのレンダリングの詳細については、w3c 定義を参照してください。
`view.dom_interactive`	数値（ns）	パーサーによりメインドキュメントの作業が終了する瞬間。詳しくは、MDN ドキュメントを参照してください。
`view.dom_content_loaded`	数値（ns）	最初の HTML ドキュメントがレンダリング以外のブロッキングスタイルシート、画像、サブフレームの読み込み完了を待たずに完全に読み込まれ解析される際に発生するイベント。詳しくは、MDN ドキュメントを参照してください。
`view.dom_complete`	数値（ns）	ページとすべてのサブリソースの準備が完了。ユーザー側では、ローディングスピナーの回転が停止。詳しくは、MDN ドキュメントを参照してください。
`view.load_event`	数値（ns）	ページが完全に読み込まれた際に発生するイベント。通常は追加のアプリケーションロジックのトリガー。詳しくは、MDN ドキュメントを参照してください。
`view.error.count`	数値	このビューについて収集されたすべてのエラーの数。
`view.long_task.count`	数値	このビューについて収集されたすべてのロングタスクの数。
`view.resource.count`	数値	このビューについて収集されたすべてのリソースの数。
`view.action.count`	数値	このビューについて収集されたすべてのアクションの数。

シングルページアプリケーション (SPA) の監視

シングルページアプリケーション (SPA) の場合、RUM ブラウザ SDK は、loading_type 属性を使用して、initial_load ナビゲーションと route_change ナビゲーションを区別します。ウェブページを操作すると、ページが完全に更新されずに異なる URL に移動する場合、RUM SDK は、loading_type:route_change を使用して新しいビューイベントを開始します。RUM は、履歴 API を使用して URL の変更を追跡します。

Datadog は、ページの読み込みに必要な時間を計算する独自のパフォーマンスメトリクス、loading_time を提供します。このメトリクスは、initial_load と route_change の両方のナビゲーションで機能します。

ロード時間の計算方法

最新のウェブアプリケーションを考慮するために、読み込み時間はネットワークリクエストと DOM のミューテーションを監視します。

Initial Load: 読み込み時間は、次の_どちらか長い方_になります。
- navigationStart と loadEventEnd の差。
- または、navigationStart からページにアクティビティがない最初の時間までの差。詳しくは、ページアクティビティの計算方法をご覧ください。
SPA Route Change: ロード時間は、URL が変わってから、そのページに初めてアクティビティが発生するまでの差に相当します。詳しくは、ページアクティビティの計算方法をご覧ください。

ページアクティビティの計算方法

RUM ブラウザ SDK はページのアクティビティを追跡し、インターフェイスが再び安定するまでの時間を推定します。ネットワークリクエストと DOM の変異を見ることで、ページにアクティビティがあると判断されます。100ms 以上継続的なリクエストがなく、DOM の変異もない場合、ページアクティビティは終了します。100ms の間にリクエストも DOM ミューテーションも発生しなかった場合、そのページはアクティビティがないと判断されます。

注意事項:

最後のリクエストまたは DOM 変異から 100ms という基準は、以下のシナリオではアクティビティの正確な判断にならないかもしれません。

アプリケーションは、定期的またはクリックごとに API へのリクエストを送信することで分析を収集します。
アプリケーションは “comet” の技術 (つまり、ストリーミングやロングポーリング) を使用しており、リクエストは不定時間保留されたままです。

このような場合のアクティビティ判定の精度を向上させるには、excludedActivityUrls を指定します。これは、ページアクティビティを計算する際に RUM ブラウザ SDK が除外するリソースのリストです。

DD_RUM.init({
    ...
    excludedActivityUrls: [
        // 正確な URL を除外する
        'https://third-party-analytics-provider.com/endpoint',

        // /comet で終わる URL を除外する
        /\/comet$/,

        // 関数が true を返す URL を除外する
        (url) => url === 'https://third-party-analytics-provider.com/endpoint',
    ]
})

Hash SPA ナビゲーション

RUM SDK は、ハッシュ (#) ナビゲーションに依存するフレームワークを自動的に監視します。SDK は HashChangeEvent を監視し、新しいビューを表示します。現在のビューのコンテキストに影響しない HTML アンカータグからくるイベントは無視されます。

独自のパフォーマンスタイミングを追加

RUM のデフォルトのパフォーマンスタイミングに加えて、アプリケーションで時間がかかっている場所をより柔軟に計測することが可能です。addTiming API を使用すると、パフォーマンスタイミングを簡単に追加できます。

たとえば、ヒーロー画像が表示されたときのタイミングを追加します。

<html>
  <body>
    <img onload="DD_RUM.addTiming('hero_image')" src="/path/to/img.png" />
  </body>
</html>

または、ユーザーが初めてスクロールしたとき:

document.addEventListener("scroll", function handler() {
    //1度だけトリガーするよう、イベントリスナーを削除
    document.removeEventListener("scroll", handler);
    DD_RUM.addTiming('first_scroll');
});

タイミングが送信されると、タイミングは @view.custom_timings.<timing_name> (たとえば @view.custom_timings.first_scroll) としてアクセス可能になります。RUM エクスプローラーまたはダッシュボードで視覚化を作成する前に、メジャーを作成する必要があります。

シングルページアプリケーションの場合、addTiming API により現在の RUM ビューの開始の相対的なタイミングが発行されます。たとえば、ユーザーがアプリケーションを表示し（初期ロード）、次に別のページを 5 秒間表示して（ルート変更）、8 秒後に addTiming をトリガーした場合、タイミングは 8-5 = 3 秒となります。

非同期セットアップを使用している場合、2 番目のパラメーターとして、独自のタイミング (現在の RUM ビューの開始または UNIX エポックタイムスタンプからの相対ミリ秒数) を指定することができます。

例:

document.addEventListener("scroll", function handler() {
    //1 度だけトリガーするよう、イベントリスナーを削除
    document.removeEventListener("scroll", handler);

    const timing = Date.now()
    DD_RUM.onReady(function() {
      DD_RUM.addTiming('first_scroll', timing);
    });
});