コンテンツにスキップ

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

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

データタイプ

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

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

グローバル属性

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

SDK 属性

フィールド 型 説明
sdk_name string 収集 SDK 名。固定値：
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk
sdk_version string 収集 SDK のバージョン情報。

アプリケーション属性

フィールド 型 説明
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 を使用してユーザー 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 画面幅*高さ、解像度

    地理 & ネットワーク属性

    フィールド 型 説明
    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_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 は、ビューポート内で表示される最大の画像またはテキストブロックのレンダリング時間（ユーザーがページに最初に移動した時点からの相対時間）を報告します。良好なユーザー体験を提供するには、LCP はページの読み込み開始から 2.5 秒以内に発生する必要があります。
    largest_contentful_paint_element_selector string LCP 指標を生成した要素のセレクター
    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) 指標は、ページの読み込みが開始されてから、ページコンテンツの一部が画面にレンダリングされるまでの時間を測定します。この指標における「コンテンツ」とは、テキスト、画像（背景画像を含む）、<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 とは異なり、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 操作に関連するエラー数

    フィードバック

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