収集された RUM ブラウザデータ

収集された RUM ブラウザデータ

RUM SDK は、メトリクスと属性が関連付けられたイベントを生成します。すべての RUM イベントには、すべてのデフォルト属性があります。例: ページの URL (view.url) や、デバイスタイプ (device.type) や 国 (geo.country) などのユーザー情報。

追加の特定のイベントタイプに固有のメトリクスと属性があります。たとえば、メトリクス view.loading_time は “view” イベントに関連付けられ、属性 resource.method は “resource” イベントに関連付けられます。

このページでは、収集された各メトリクスと属性について説明します。このデータで何ができるかについてのガイダンスについては、以下を参照してください。

デフォルト属性

これらの各イベントタイプには、デフォルトで次の属性が付加されています。したがって、照会される RUM イベントタイプに関係なくそれらを使用できます。

コア

属性名 タイプ 説明
type 文字列 イベントのタイプ (viewresource など)。
application.id 文字列 Datadog アプリケーション ID。

ビュー属性

RUM アクション、エラー、リソース、ロングタスクのイベントには、収集時のアクティブな RUM ビューイベントに関する情報が含まれています。

属性名 タイプ 説明
view.id 文字列 ページビューごとにランダムに生成された ID。
view.loading_type 文字列 ページ読み込みのタイプ: initial_load または route_change。詳細については、シングルページアプリケーションサポートドキュメントを参照してください。
view.referrer 文字列 現在リクエストされているページへのリンクがたどられた前のウェブページの URL。
view.url 文字列 ビューの URL。
view.url_hash 文字列 URL のハッシュ部分。
view.url_host 文字列 URL のホスト部分。
view.url_path 文字列 URL のパス部分。
view.url_path_group 文字列 同様の URL に対して生成された自動 URL グループ。( /dashboard/123/dashboard/456 に対する /dashboard/? など)。
view.url_query オブジェクト クエリパラメーターの key/value 属性として分解された、URL のクエリ文字列部分。
view.url_scheme オブジェクト URL のスキーム部分。

デバイス

以下のデバイス関連属性は、Datadog により収集されるすべてのイベントに自動的にアタッチされます。

属性名 タイプ 説明
device.type 文字列 デバイスによって報告されたデバイスタイプ (User-Agent HTTP ヘッダー)
device.brand 文字列 デバイスによって報告されたデバイスブランド (User-Agent HTTP ヘッダー)
device.model 文字列 デバイスによって報告されたデバイスモデル (User-Agent HTTP ヘッダー)
device.name 文字列 デバイスによって報告されたデバイス名 (User-Agent HTTP ヘッダー)

オペレーティングシステム

以下の OS 関連属性は、Datadog により収集されるすべてのイベントに自動的にアタッチされます。

属性名 タイプ 説明
os.name 文字列 デバイスによって報告された OS 名 (User-Agent HTTP ヘッダー)
os.version 文字列 デバイスによって報告された OS バージョン (User-Agent HTTP ヘッダー)
os.version_major 文字列 デバイスによって報告された OS バージョンメジャー (User-Agent HTTP ヘッダー)

位置情報

以下は、IP アドレスのジオロケーションに関連する属性です。

完全名 タイプ 説明
geo.country 文字列 国の名前。
geo.country_iso_code 文字列 国の ISO コード (米国は US、フランスは FR など)。
geo.country_subdivision 文字列 その国で最大規模の地方区分 (米国は California 州、フランスは Sarthe 県など)。
geo.country_subdivision_iso_code 文字列 その国で最大規模の地方区分の ISO コード (米国は CA、フランスは SA など)。
geo.continent_code 文字列 大陸の ISO コード (EUASNAAFANSAOC)。
geo.continent 文字列 大陸名 (EuropeAustraliaNorth AmericaAfricaAntarticaSouth AmericaOceania)。
geo.city 文字列 都市名 (ParisNew York など)。

: デフォルトでは、Datadog はクライアントの IP アドレスを保存します。IP アドレスの収集を停止したい場合は、サポートにお問い合わせください。これは、上記のジオロケーション属性のコレクションには影響しません。

ユーザー属性

デフォルトの属性に加えて、ユーザーセッションを識別することで、すべての RUM イベントタイプにユーザー関連データを追加できます。これにより、特定のユーザーの移動を追跡し、エラーの影響を最も受けているユーザーを特定し、最も重要なユーザーのパフォーマンスを監視できます。

イベント固有のメトリクスと属性

RUM SDK は、次の 6 種類のイベントを生成します。

イベントタイプ 保存期間 説明
セッション 30 日 ユーザーセッションは、ユーザーが Web アプリケーションの閲覧を始めると開始されます。これには、ユーザーに関する高レベルの情報 (ブラウザー、デバイス、ジオロケーション) が含まれています。これは、ユーザージャーニー中に収集されたすべての RUM イベントを一意の session.id 属性で集約します。
ビュー 30 日 ビューイベントは、ユーザーが Web アプリケーションのページにアクセスするたびに生成されます。ユーザーが同じページにいる間、リソース、ロングタスク、エラー、アクションのイベントは、view.id 属性を使用して関連する RUM ビューにリンクされます。
Resource 15 日 リソースイベントは、Web ページにロードされた画像、XHR、Fetch、CSS、または JS ライブラリに対して生成されます。詳細なロードタイミング情報が含まれています。
ロングタスク 15 日 ロングタスクイベントは、メインスレッドを 50 ミリ秒以上ブロックするブラウザ内のすべてのタスクに対して生成されます。
エラー 30 日 RUM は、ブラウザによって発行されたすべてのフロントエンドエラーを収集します。
アクション 30 日 RUM アクションイベントは、ユーザージャーニー中のユーザーインタラクションを追跡し、カスタムユーザーアクションを監視するために手動で送信することもできます。

次の図は、RUM イベント階層を示しています。

セッションメトリクス

メトリクス タイプ 説明
session.time_spent 数値(ns) ユーザーセッションの期間。
session.view.count 数値 このセッションで収集されたすべてのビューの数。
session.error.count 数値 このセッションで収集されたすべてのエラーの数。
session.resource.count 数値 このセッションで収集されたすべてのリソースの数。
session.action.count 数値 このセッションで収集されたすべてのアクションの数。
session.long_task.count 数値 このセッションで収集されたすべてのロングタスクの数。

セッション属性

属性名 タイプ 説明
session.id 文字列 セッションごとにランダムに生成された ID。
session.ip 文字列 クライアントの IP アドレス。この属性の収集を停止する場合は、サポートに連絡してください。
session.type 文字列 セッションのタイプ: user または syntheticsSynthetic モニタリングブラウザテストのセッションは請求から除外されます。
session.referrer 文字列 現在リクエストされているページへのリンクがたどられた前のウェブページの URL。
session.initial_view.id 文字列 ユーザーによって生成された最初の RUM ビューの ID。
session.initial_view.url_host 文字列 URL のホスト部分。
session.initial_view.url_path 文字列 URL のパス部分。
session.initial_view.url_path_group 文字列 同様の URL に対して生成された自動 URL グループ。( /dashboard/123/dashboard/456 に対する /dashboard/? など)。
session.initial_view.url_query オブジェクト クエリパラメーターの key/value 属性として分解された、URL のクエリ文字列部分。
session.initial_view.url_scheme オブジェクト URL のスキーム部分。
session.last_view.id 文字列 ユーザーによって生成された最後の RUM ビューの ID。
session.last_view.url_host 文字列 URL のホスト部分。
session.last_view.url_path 文字列 URL のパス部分。
session.last_view.url_path_group 文字列 同様の URL に対して生成された自動 URL グループ。( /dashboard/123/dashboard/456 に対する /dashboard/? など)。
session.last_view.url_query オブジェクト クエリパラメーターの key/value 属性として分解された、URL のクエリ文字列部分。
session.last_view.url_scheme オブジェクト URL のスキーム部分。

ビュータイミングメトリクス

属性 タイプ 説明
view.time_spent 数値(ns) 現在のビューに費やした時間。
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 数値 このビューについて収集されたすべてのアクションの数。

リソースタイミングメトリクス

アプリケーションリソースのロードについて、ネットワークの詳細なタイミングデータが、Performance Resource Timing API を使用して収集されます。

メトリクス タイプ 説明
duration 数値 リソースのロードにかかった全時間。
resource.size 数値(バイト) リソースのサイズ。
resource.connect.duration 数値(ns) サーバーへの接続が確立されるまでにかかった時間(connectEnd - connectStart)。
resource.ssl.duration 数値(ns) TLS ハンドシェイクにかかった時間。最後のリクエストが HTTPS 経由ではなかった場合、このメトリクスは収集されません(connectEnd - secureConnectionStart)。
resource.dns.duration 数値(ns) 最後のリクエストの DNS 名が解決されるまでにかかった時間(domainLookupEnd - domainLookupStart)。
resource.redirect.duration 数値(ns) 後続の HTTP リクエストにかかった時間(redirectEnd - redirectStart)。
resource.first_byte.duration 数値(ns) 応答の最初のバイトを受信するまでにかかった時間(responseStart - RequestStart)。
resource.download.duration 数値(ns) 応答のダウンロードにかかった時間(responseEnd - responseStart)。

リソースの属性

属性 タイプ 説明
resource.type 文字列 収集されるリソースのタイプ (cssjavascriptmediaXHRimage など)。
resource.method 文字列 HTTP メソッド (POSTGET など)。
resource.status_code 数値 応答ステータスコード。
resource.url 文字列 リソースの URL。
resource.url_host 文字列 URL のホスト部分。
resource.url_path 文字列 URL のパス部分。
resource.url_query オブジェクト クエリパラメーターの key/value 属性として分解された、URL のクエリ文字列部分。
resource.url_scheme 文字列 URL のプロトコル名 (HTTP または HTTPS)。
resource.provider.name 文字列 リソースプロバイダー名。デフォルトは unknown となります。
resource.provider.domain 文字列 リソースプロバイダーのドメイン。
resource.provider.type 文字列 リソースプロバイダーのタイプ (first-partycdnadanalytics など)。

ロングタスクタイミングメトリクス

メトリクス タイプ 説明
long_task.duration 数値 ロングタスクの時間。

エラー属性

属性 タイプ 説明
error.source 文字列 エラーの発生元 (consolenetwork など)。
error.type 文字列 エラーのタイプ (場合によってはエラーコード)。
error.message 文字列 イベントについて簡潔にわかりやすく説明する 1 行メッセージ。
error.stack 文字列 スタックトレースまたはエラーに関する補足情報。

ソースエラー

ソースエラーには、エラーに関するコードレベルの情報が含まれます。エラーの種類に関する詳細は、 MDN ドキュメントを参照してください。

属性 タイプ 説明
error.type 文字列 エラーのタイプ (場合によってはエラーコード)。

アクションタイミングメトリクス

メトリクス タイプ 説明
action.loading_time 数値(ns) アクションの読み込み時間。ユーザーアクションのドキュメントで計算方法を確認してください。
action.long_task.count 数値 このアクションについて収集されたすべてのロングタスクの数。
action.resource.count 数値 このアクションについて収集されたすべてのリソースの数。
action.error.count 数値 このアクションについて収集されたすべてのエラーの数。

アクションの属性

属性 タイプ 説明
action.id 文字列 ユーザーアクションの UUID。
action.type 文字列 ユーザーアクションのタイプ。カスタムユーザーアクションの場合、custom に設定されます。
action.target.name 文字列 ユーザーが操作したエレメント。自動収集されたアクションのみ対象
action.name 文字列 作成されたユーザーフレンドリーな名称 (Click on #checkout など)。カスタムユーザーアクションの場合は、API コールで提供されたアクション名。

その他の参考資料