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

概要

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

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

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

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

デフォルト属性

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

コア

属性名	タイプ	説明
`type`	文字列	イベントのタイプ (`view` や `resource` など)。
`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.continent_code`	文字列	大陸の ISO コード (`EU`、`AS`、`NA`、`AF`、`AN`、`SA`、`OC`)。
`geo.continent`	文字列	大陸名 (`Europe`、`Australia`、`North America`、`Africa`、`Antarctica`、`South America`、`Oceania`)。
`geo.city`	文字列	都市名 (`Paris`、`New York` など)。

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

ユーザー属性

デフォルトの属性に加えて、ユーザーセッションを識別することで、すべての 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.is_active`	boolean	セッションが現在アクティブであるかどうかを示します。セッションは、ユーザーがアプリケーションから移動したり、ブラウザウィンドウを閉じたりすると終了し、4 時間の活動または 15 分の非活動時間が経過すると失効します。
`session.type`	文字列	セッションのタイプ: `user` または `synthetics`。Synthetic モニタリングブラウザテストのセッションは請求から除外されます。
`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`	文字列	収集されるリソースのタイプ (`css`、`javascript`、`media`、`XHR`、または `image` など)。
`resource.method`	文字列	HTTP メソッド (`POST` または `GET` など)。
`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-party`、`cdn`、`ad`、または `analytics` など)。

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

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

エラー属性

属性	タイプ	説明
`error.source`	文字列	エラーの発生元 (`console`、`network` など)。
`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 コールで提供されたアクション名。