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

概要

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

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

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

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

RUM イベント階層

デフォルト属性

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

コア

属性名タイプ説明
type文字列イベントのタイプ (view や resource など)。
application.id文字列RUM アプリケーションを作成する際に生成される Datadog アプリケーション ID。
application.name文字列Datadog アプリケーションの名前。
service文字列サービスとは、ブラウザアプリケーションで特定の機能を提供するチームによって構築された一連のページを指します。Web ページをサービスに割り当てるには、手動ビュー追跡を使用します。

ビュー属性

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 アドレスを保存します。ユーザーデータの自動収集を管理する方法については、リアルユーザーモニタリングデータセキュリティで詳しく説明しています。

ユーザー属性

デフォルトの属性に加えて、ユーザーセッションを識別することで、すべての 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.is_activebooleanセッションが現在アクティビティであるかどうかを示します。セッションは、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.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数値このビューについて収集されたすべてのアクションの数。

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

アプリケーションリソースのロードについて、ネットワークの詳細なタイミングデータが、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 コールで提供されたアクション名。

フラストレーションシグナルフィールド

フィールドタイプ説明
session.frustration.count数値1 つのセッションに関連するすべてのフラストレーションシグナルの数。
view.frustration.count数値1 つのビューに関連するすべてのフラストレーションシグナルの数。
action.frustration.type:dead_click文字列RUM ブラウザ SDK で検出されたデッドクリック。
action.frustration.type:rage_click文字列RUM ブラウザ SDK で検出されたレイジークリック。
action.frustration.type:error_click文字列RUM ブラウザ SDK で検出されたエラークリック。

その他の参考資料

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

Datadog リアルユーザーモニタリングのご紹介ブログ more more RUM データの変更とコンテキストの追加DOCUMENTATION more more Datadog でビューを検索するDOCUMENTATION more more イベントへの視覚化の適用DOCUMENTATION more more Datadog 標準属性ドキュメント more more