概要
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 ビューにリンクされます。 |
Resource | 15 日 | リソースイベントは、Web ページにロードされた画像、XHR、Fetch、CSS、または JS ライブラリに対して生成されます。詳細なロードタイミング情報が含まれています。 |
ロングタスク | 15 日 | ロングタスクイベントは、メインスレッドを 50 ミリ秒以上ブロックするブラウザ内のすべてのタスクに対して生成されます。 |
エラー | 30 日 | RUM は、ブラウザによって発行されたすべてのフロントエンドエラーを収集します。 |
アクション | 30 日 | RUM アクションイベントは、ユーザージャーニー中のユーザーインタラクションを追跡し、カスタムユーザーアクションを監視するために手動で送信することもできます。 |
次の図は、RUM イベント階層を示しています。
デフォルト属性
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_active | ブール値 | セッションが現在アクティビティであるかどうかを示します。セッションは、4 時間のアクティビティまたは 15 分の非アクティブの後に終了します。 |
session.type | 文字列 | セッションのタイプ: user または synthetics 。Synthetic Monitoring Browser Tests のセッションは請求対象外です。 |
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.largest_contentful_paint_target_selector | 文字列 (CSS セレクタ) | 最大のコンテンツ描画に対応する要素の CSS セレクタ。 |
view.first_input_delay | 数値(ns) | ユーザーがページを最初に操作してからブラウザが応答するまでの経過時間。 |
view.first_input_delay_target_selector | 文字列 (CSS セレクタ) | ユーザーが最初に操作した要素の CSS セレクタ。 |
view.interaction_to_next_paint | 数値(ns) | ユーザーがページを操作してから、次の描画が行われるまでの最長の時間。 |
view.interaction_to_next_paint_target_selector | 文字列 (CSS セレクタ) | 次の描画が行われるまでの最長インタラクションに関連する要素の CSS セレクタ。 |
view.cumulative_layout_shift | 数値 | 動的に読み込まれるコンテンツ (サードパーティの広告など) による予期しないページ移動を定量化します。0 はシフトが発生していないことを意味します。 |
view.cumulative_layout_shift_target_selector | 文字列 (CSS セレクタ) | ページの CLS に最も寄与する要素の CSS セレクタ。 |
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 | 数値 | 応答ステータスコード (fetch/XHR リソースにのみ適用)。 |
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 など)。エラーソースを参照してください。 |
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 で検出されたエラークリック。 |
UTM 属性
フィールド | タイプ | 説明 |
---|
view.url_query.utm_source | 文字列 | トラフィックのソースを追跡する URL のパラメーター。 |
view.url_query.utm_medium | 文字列 | トラフィックの発信元チャンネルを追跡する URL のパラメーター。 |
view.url_query.utm_campaign | 文字列 | そのビューに関連付けられた特定のマーケティングキャンペーンを識別する URL のパラメーター。 |
view.url_query.utm_content | 文字列 | マーケティングキャンペーン内でユーザーがクリックした特定の要素を特定する URL 内のパラメーター。 |
view.url_query.utm_term | 文字列 | ユーザーが特定のキャンペーンをトリガーするために検索したキーワードを追跡する URL のパラメーター。 |
その他の参考資料