コンテンツにスキップ

Web アプリケーションデータ収集

アプリケーションデータを Guance に収集した後、Guance コンソールでカスタムシナリオの設定や異常検出イベントの設定を行うことができます。

データタイプ

Guance のリアルユーザーモニタリング（RUM）には、以下の 6 種類のデータタイプがあります。

タイプ 説明
session ユーザーセッション情報の記録。現在のセッションにおいて、セッションディメンションに基づいてユーザーのページ、リソース、操作、エラー、ロングタスクに関連するアクセスデータを取得します。
view ユーザーがページにアクセスするたびに、ページビューレコードが生成されます。ユーザーが同じページに留まっている間、リソース、ロングタスク、エラー、操作の記録は view_id 属性を介して関連する RUM ビューにリンクされます。
resource ユーザーがページにアクセスする際に読み込まれるリソース情報の記録。
error RUM コレクターがブラウザ上で収集したすべてのフロントエンドエラー。
long_task ブラウザにおいてメインスレッドを 50ms 以上ブロックするタスクに対して、ロングタスクレコードが 1 件生成されます。
action ユーザーのページ閲覧中のすべてのユーザーインタラクションの記録を追跡します。

グローバル属性

RUM のシナリオ構築とイベントアラートは、以下のグローバル属性を使用してクエリできます。

SDK 属性

フィールド タイプ 説明
sdk_name string コレクター名。固定値：
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk
sdk_version string コレクターのバージョン情報。

アプリケーション属性

フィールド タイプ 説明
app_id string 必須。RUM アプリケーションの一意の ID 識別子。Guance コンソールでモニターを作成する際に自動生成されます。
env string 必須。環境フィールド。属性値：prod/gray/pre/common/local。内訳：
prod：本番環境；
gray：カナリア環境；
pre：ステージング環境；
common：日常環境；
local：ローカル環境。
version string 必須。バージョン番号。
service string 必須。RUM SDK 内で設定された service フィールドに対応する値。

ユーザー & セッション属性

フィールド タイプ 説明
userid string デフォルトではブラウザの Cookie を userid として取得します。カスタムユーザー識別子を使用してユーザー ID を設定した場合、userid は定義された値と一致します。
❗️ Cookie の有効期限は 60 日です。
session_id string セッション ID（ユーザーセッションは 15 分間インタラクションがないと期限切れとみなされます）。
session_type string セッションタイプ。参照値：user & synthetics：
  • user：RUM 機能によって生成されたデータ；
  • synthetics：ヘッドレス Synthetic テストによって生成されたデータ。
    		•
    is_signin boolean 登録ユーザーかどうか。属性値：True / False。

    デバイス & 解像度属性

    フィールド タイプ 説明
    os string オペレーティングシステム
    os_version string オペレーティングシステムのバージョン
    os_version_major string デバイスから報告された主要な OS バージョン
    browser string ブラウザプロバイダー
    browser_version string ブラウザのバージョン
    browser_version_major string ブラウザの主要バージョン情報
    screen_size string 画面幅*高さ、解像度
    Windows システムのバージョン識別

    ブラウザが User-Agent Client Hints を提供する場合、SDK は platformVersion を使用して Windows 10 と Windows 11 を区別します。この機能をサポートしていない、高エントロピー値の返却を拒否する、またはクエリがタイムアウトしたブラウザの場合、 SDK は引き続き navigator.userAgent を使用します。Windows 11 の従来の User-Agent は依然として Windows NT 10.0 を報告するため、この場合 Windows 10 と Windows 11 を区別できません。

    地理 & ネットワーク属性

    フィールド タイプ 説明
    ip string ユーザーアクセス IP アドレス
    isp string プロバイダ
    network_type string ネットワーク接続タイプ。属性値の参照：
    wifi | 2g | 3g | 4g | 5g | unknown（不明なネットワーク）| unreachable（ネットワーク不可）
    country string 国
    country_iso_code string 国の iso_code
    province string 省
    city string 都市

    カスタム属性

    グローバル属性以外にも、カスタム属性（SDK はユーザーがカスタムタグデータを設定可能）を使用して、シナリオの構築やイベントアラートの設定ができます。カスタム属性はグローバル属性ではありません。カスタム属性を使用することで、ユーザーがアプリケーションにアクセスするプロセス全体を追跡し、ユーザーが影響を受けるアクセス状況を特定・発見し、ユーザーアクセスのパフォーマンスを監視できます。

    その他のデータタイプの属性

    Session

    属性

    フィールド タイプ 説明
    session_id string セッション ID（ユーザーセッションは 15 分間インタラクションがないと期限切れとみなされます）
    session_type string セッションタイプ。参照値：user & synthetics：
  • user：RUM 機能によって生成されたデータ；
  • synthetics：ヘッドレス Synthetic テストによって生成されたデータ。
    		•
    session_first_view_id string 現在のセッションの最初のページの view_id
    session_first_view_url string 現在のセッションの最初のページの URL
    session_first_view_host string 現在のセッションの最初のページのドメイン
    session_first_view_path string 現在のセッションの最初のページのパス
    session_first_view_path_group string 現在のセッションの最初のページのパスグループ
    session_first_view_url_query string 現在のセッションの最初のページのクエリ情報
    session_first_view_name string 現在のセッションの最初のページのパスグループ。session_first_view_path_group フィールドと同じ
    session_last_view_id string 現在のセッションの最後にアクセスしたページの view_id
    session_last_view_url string 現在のセッションの最後のページの URL
    session_last_view_host string 現在のセッションの最後のページのドメイン
    session_last_view_path string 現在のセッションの最後のページのパス
    session_last_view_path_group string 現在のセッションの最後のページのパスグループ
    session_last_view_url_query object 現在のセッションの最後のページのクエリ情報
    session_last_view_name string 現在のセッションの最後のページのパスグループ。session_last_view_path_group フィールドと同じ

    統計指標

    フィールド タイプ 説明
    time_spent number(ns) 現在のセッションの継続時間
    session_time_spent_count number 4 時間間隔でカウントし、超過分は 4 時間ごとに 1 を加算して統計
    session_view_count number 現在のセッションに関連する view_id の数
    session_error_count number 現在のセッションで発生したエラーの数
    session_resource_count number 現在のセッションで読み込まれたリソースの数
    session_action_count number 現在のセッションでのユーザー操作の回数
    session_long_task_count number 現在のセッションで発生したロングタスクの回数

    View

    属性

    フィールド タイプ 説明
    view_id string ページアクセスごとに生成される一意の ID
    view_loading_type string ページ読み込みタイプ。参照値：initial_load、route_change。route_change は SPA ページ読み込みモード
    view_navigation_type string RUM SDK 3.3.9 以降で提供される SPA ルートナビゲーションタイプ。参照値：push、replace、traverse。ブラウザが Soft Navigation API をサポートする場合はネイティブ値を優先、それ以外は Navigation API、History API、または Hash ルートの互換ロジックで生成されます。ナビゲーション元を特定できる route_change View にのみ存在します。
    view_referrer string ページの参照元
    view_url string ページ URL
    view_host string ページ URL のドメイン部分
    view_path string ページ URL のパス部分
    view_path_group string ページ URL のパスグループ
    view_url_query string ページ URL のクエリ部分
    session_has_replay boolean 現在の View が属するセッションに、関連付け可能なセッションリプレイデータがすでに生成されているかどうか

    指標

    指標 タイプ（単位） 説明
    loading_time number(ns) ページが ready 状態になり、ネットワークリクエストや DOM の変更がない状態になるまでの時間。詳細は ページ Loading Time を参照
    largest_contentful_paint number(ns) LCP は、ビューポート内で表示される最大の画像またはテキストブロックのレンダリング時間を報告します。初回読み込みはページナビゲーションを起点とします。RUM SDK 3.3.9 以降、Chrome Soft Navigation API をサポートする場合、SPA ルート切り替えは対応するソフトナビゲーションを起点とします。優れたユーザー体験を提供するには、LCP は 2.5 秒以内に発生する必要があります。
    largest_contentful_paint_element_selector string LCP 指標を生成した要素のセレクター。初回読み込みおよびネイティブ Soft Navigation API をサポートする SPA ルート切り替えの両方で存在する可能性があります
    cumulative_layout_shift number 累積レイアウトシフト。視覚的な安定性を測定します。優れたユーザー体験を提供するには、ページの CLS は 0.1 以下に保つ必要があります。
    cumulative_layout_shift_target_selector string CLS 指標を生成した要素のセレクター
    first_input_delay number(ns) ページの最初のインタラクションの入力遅延を測定します。現在の Core Web Vitals では FID は INP に置き換えられています。
    first_input_time number(ns) 現在の View の開始から最初のインタラクションまでの時間
    first_input_target_selector string 最初のインタラクションを生成した要素のセレクター
    interaction_to_next_paint number(ns) ページ訪問全体を通して、ユーザーインタラクションに対する全体的な応答性を測定します。入力遅延、イベント処理、次のフレームの描画時間が含まれます
    interaction_to_next_paint_target_selector string INP 指標を生成したインタラクション要素のセレクター
    first_contentful_paint number(ns) 初回コンテンツ描画 (FCP) 指標は、初回読み込みまたは Chrome Soft Navigation API をサポートする SPA ルート切り替えの開始後、ページコンテンツの一部が画面上でレンダリングを完了するまでの時間を測定します。SPA ルート切り替えの指標は RUM SDK 3.3.9 以降で提供されます。この指標において、「コンテンツ」とはテキスト、画像（背景画像を含む）、<svg> 要素、または非白色の <canvas> 要素を指します。w3c を参照してください。
    first_byte number(ns) ページリクエストから、ページ応答の最初のバイトを受信するまでの時間
    dom_interactive number(ns) パーサーがドキュメントの解析を完了した時間。詳細は MDN を参照
    dom_content_loaded number(ns) 純粋な HTML が完全に読み込まれ解析されたときに、DOMContentLoaded イベントが発生します。スタイルシート、画像、またはサブフレームの読み込み完了を待つ必要はありません。詳細は MDN を参照
    dom_complete number(ns) ページとすべてのサブリソースの準備が完了した状態。ユーザーにとっては、読み込み中のアニメーションが停止したことを意味します。詳細は MDN を参照
    load_event number(ns) ページ全体と、スタイルシートや画像などのすべての依存リソースが読み込みを完了したときに発生します。DOMContentLoaded とは異なり、後者は依存リソースの読み込みを待たずにページの DOM 読み込みが完了した時点で発生します。詳細は MDN を参照
    first_paint_time number（ns） 現在の SDK が計算するドキュメント応答フェーズの所要時間
    計算方法：responseEnd - fetchStart
    resource_load_time number（ns） リソース読み込み時間
    計算方法：loadEventStart - domContentLoadedEventEnd
    time_to_interactive number（ns） 初回インタラクティブまでの時間
    計算方法：domInteractive - fetchStart
    dom number（ns） DOM 解析の所要時間
    計算方法：domComplete - domInteractive
    dom_ready number（ns） DOM Ready 時間
    計算方法：domContentLoadedEventEnd - fetchStart
    time_spent number（ns） ページ滞在時間
    is_active boolean ユーザーがまだアクティブ状態かどうかを判断します。参照値：true / false

    統計指標

    フィールド タイプ 説明
    view_error_count number ページ読み込みごとに発生したエラーの回数
    view_resource_count number ページ読み込みごとにリクエストされたリソースの数
    view_long_task_count number ページ読み込みごとに発生したロングタスクの回数
    view_action_count number ページ表示中に行われた操作の回数
    frustration_count number 現在の View に関連するフラストレーション行動の数
    view_apdex_level number ページの Apdex 満足度。
    基本指標：first_paint_time（秒単位に換算）
    参照値：0/1/2/3/4/5/6/7/8/9 (first_paint_time の値に基づき、9 は >= 9 秒を意味)

    Resource

    ページリソース、XHR、fetch に加えて、実験的機能を有効にすると、ネイティブ WebSocket 接続も resource_type = websocket の Resource を生成します。WebSocket には HTTP レスポンスがないため、 resource_status、resource_method、HTTP timing は含まれません。接続、メッセージ、 クローズフィールドについては WebSocket 長接続収集 を参照してください。

    View 属性

    フィールド タイプ 説明
    view_id string ページアクセスごとに生成される一意の ID
    is_active boolean ユーザーがまだアクティブ状態かどうかを判断します。参照値: true | false
    view_loading_type string ページ読み込みタイプ。参照値：initial_load
    view_referrer string ページの参照元
    view_url string ページ URL
    view_host string ページ URL のドメイン部分
    view_path string ページ URL のパス部分
    view_path_group string ページ URL のパスグループ
    view_url_query string ページ URL のクエリ部分

    Resource 属性

    フィールド タイプ 説明
    resource_url string リソース URL
    resource_url_host string リソース URL のドメイン部分
    resource_url_path string リソース URL のパス部分
    resource_url_query string リソース URL のクエリ部分
    resource_url_path_group string リソース URL のパスグループ
    resource_type string リソースのカテゴリ
    resource_method string リソースのリクエスト方法
    resource_status string リソースリクエストが返したステータス値
    resource_status_group string リソースリクエストが返したステータスのグループ値

    指標

    フィールド タイプ 説明
    resource_size number リソースサイズ。デフォルト単位：byte
    resource_dns number（ns） リソース読み込みの DNS 解決時間
    計算方法：domainLookupEnd - domainLookupStart
    resource_tcp number（ns） リソース読み込みの TCP 接続時間
    計算方法：connectEnd - connectStart
    resource_ssl number（ns） リソース読み込みの SSL 接続時間
    計算方法：connectEnd - secureConnectStart
    resource_ttfb number（ns） リソース読み込みのリクエスト応答時間
    計算方法：responseStart - requestStart
    resource_trans number（ns） リソース読み込みのコンテンツ転送時間
    計算方法：responseEnd - responseStart
    resource_first_byte number（ns） リソース読み込みの最初のパケット時間
    計算方法：responseStart - domainLookupStart
    duration number（ns） リソース読み込み時間
    計算方法：duration(responseEnd - startTime)

    Error

    View 属性

    フィールド タイプ 説明
    view_id string ページアクセスごとに生成される一意の ID
    is_active boolean ユーザーがまだアクティブ状態かどうかを判断します。参照値: true | false
    view_loading_type string ページ読み込みタイプ。参照値：initial_load
    view_referrer string ページの参照元
    view_url string ページ URL
    view_host string ページ URL のドメイン部分
    view_path string ページ URL のパス部分
    view_path_group string ページ URL のパスグループ
    view_url_query string ページ URL のクエリ部分

    Error 属性

    フィールド タイプ 説明
    error_source string エラーの発生源。参照値：console | network | source | custom
    error_type string エラータイプ。参照リンク：error type
    resource_status string リソースリクエストが返したステータス値
    resource_url string リソース URL
    resource_url_host string リソース URL のドメイン部分
    resource_url_path string リソース URL のパス部分
    resource_url_path_group string リソース URL のパスグループ
    resource_method string リソースのリクエスト方法

    指標

    フィールド タイプ 説明
    error_message string エラーメッセージ
    error_stack string エラースタック

    Long Task

    View 属性

    フィールド タイプ 説明
    view_id string ページアクセスごとに生成される一意の ID
    is_active boolean ユーザーがまだアクティブ状態かどうかを判断します。参照値: true | false
    view_loading_type string ページ読み込みタイプ。参照値：initial_load
    view_referrer string ページの参照元
    view_url string ページ URL
    view_host string ページ URL のドメイン部分
    view_path string ページ URL のパス部分
    view_path_group string ページ URL のパスグループ
    view_url_query string ページ URL のクエリ部分

    指標

    フィールド タイプ 説明
    duration number（ns） ページ読み込み時に発生したロングタスクの所要時間

    Action

    View 属性

    フィールド タイプ 説明
    view_id string ページアクセスごとに生成される一意の ID
    is_active boolean ユーザーがまだアクティブ状態かどうかを判断します。参照値: true | false
    view_loading_type string ページ読み込みタイプ。参照値：initial_load
    view_referrer string ページの参照元
    view_url string ページ URL
    view_host string ページ URL のドメイン部分
    view_path string ページ URL のパス部分
    view_path_group string ページ URL のパスグループ
    view_url_query string ページ URL のクエリ部分

    Action 属性

    フィールド タイプ 説明
    action_id string ユーザーのページ操作時に生成される一意の ID
    action_name string 操作名
    action_type string 操作タイプ

    指標

    フィールド タイプ 説明
    duration number（ns） ページ操作の所要時間

    統計指標

    フィールド タイプ 説明
    action_long_task_count number 操作に関連するロングタスクの回数
    action_resource_count number 操作に関連するリソースリクエストの回数
    action_error_count number 操作に関連するエラーの回数

    フィードバック

    このページは役に立ちましたか？