コンテンツにスキップ

iOS/tvOS/macOS アプリデータ収集


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

データタイプ

Guanceのリアルユーザーモニタリング(RUM)には、6 種類のデータタイプがあります:

iOS SDK が直接報告する RUM データタイプは view、resource、error、long_task、action です。session はセッション単位のデータであり、SDK が報告する RUM データを基に集約して生成されます

タイプ 説明
session ユーザーセッション情報の記録。現在のセッション内で、セッション単位のユーザーページ、リソース、操作、エラー、ロングタスクに関連するアクセスデータを基にします。
view ユーザーがモバイルアプリケーションのページにアクセスするたびに、ビュー記録が生成されます。ユーザーが同じページに留まっている間、リソース、ロングタスク、エラー、操作の記録は view_id 属性を介して関連する RUM ビューにリンクされます。
resource ユーザーがページにアクセスする際に読み込まれるリソース情報の記録。
error モバイルアプリケーションで発生した例外またはクラッシュ。
long_task アプリケーション内でメインスレッドを指定された継続時間のしきい値を超えてブロックするタスクごとに、ロングタスクイベントが生成されます。
action モバイルアプリケーション内のユーザーアクティビティ(アプリの起動、タップ、スワイプ、戻るなど)を記録します。各アクションには一意の action_id が付与されます。

グローバル属性

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

SDK 属性

フィールド タイプ 説明
sdk_name string コレクター名。固定名:
df_macos_rum_sdk
df_ios_rum_sdk
df_tvos_rum_sdk
df_android_rum_sdk
sdk_version string コレクターのバージョン情報
sdk_pkg_info object SDK パッケージ情報

アプリケーション属性

フィールド タイプ 説明
app_id string 必須。ユーザーアクセスアプリケーションの一意の ID 識別子。Guanceコンソールでモニタリングを作成する際に自動生成されます。
application_uuid string アプリケーション UUID。iOS SDK はメイン Mach-O UUID から取得します
env string 必須。環境フィールド。属性値:prod/gray/pre/common/local。内訳:
prod:本番環境
gray:グレー環境
pre:プレリリース環境
common:日常環境
local:ローカル環境
version string 必須。バージョン番号。
service string 任意。所属する業務またはサービスの名称。固定名:
df_rum_ios
df_rum_tvos
df_rum_android
df_rum_windows
df_rum_linux

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

フィールド タイプ 説明
userid string 未ログインユーザーはランダムな uuid を userid として使用し、ログインユーザーはアプリケーションバックエンドで生成されたユーザー id を使用します。
user_name string 任意。ユーザー名。
user_email string 任意。ユーザーメールアドレス。
session_id string セッション id。15 分以上操作がない場合、新しい session_id が生成されます。
session_type string セッションタイプ。参考値:user & synthetics
user:RUM 機能によって生成されたデータ;
synthetics:ヘッドレス Synthetic テストによって生成されたデータ。
session_start_reason string SDK 1.6.8+:RUM イベントにおけるセッションの開始または更新理由。sdk_init:SDK の初期化;inactivity_timeout:セッションの無操作時間制限を超過;max_duration:セッションの最大継続時間に到達;sampling_changed:サンプリング設定の変更;unknown:理由不明。このフィールドはセッションコンテキストに属し、SDK が Session データを個別に報告することを示すものではありません
is_signin boolean 登録ユーザーかどうか。属性値:T & F。
session_has_replay boolean 現在のセッションが Session Replay データに関連付けられているかどうか。Session Replay 関連機能を有効化すると、View、Resource、Error、Long Task、Action にこのフィールドを書き込めます
visitor_id string SDK 1.6.8+:有効な Visitor ID 設定を有効化した後に関連付けられる SDK 管理の匿名識別子。ログインユーザー ID とは異なります。Visitor ID を参照してください
custom_keys string RUM カスタム属性キーのリスト

デバイス & 解像度属性

フィールド タイプ 説明
device string モバイルデバイスのベンダー
model string モバイルデバイスのモデル
device_uuid string モバイルデバイスの一意の ID。UIDevice.identifierForVendor を使用して生成
os string オペレーティングシステム情報
os_version string オペレーティングシステムのバージョン
os_version_major string オペレーティングシステムのメジャーバージョン
screen_size string 画面解像度
arch string CPU アーキテクチャ(例:arm64、arm64e、x86_64)

地理位置 & ネットワーク属性

フィールド タイプ 説明
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 はセッション単位のデータであり、通常は SDK が報告する RUM データに基づいてサーバー側で生成または集約されます。iOS SDK が単独で直接報告する measurement ではありません

属性

フィールド タイプ 説明
session_id string セッション id
session_type string セッションタイプ。参考値:user & synthetics
user:RUM 機能によって生成されたデータ;
synthetics:ヘッドレス Synthetic テストによって生成されたデータ。
session_referrer string セッションの参照元。通常は記録元のページアドレスです。
session_first_view_id string 現在のセッションの最初のページの view_id
session_first_view_name string 現在のセッションの最初のページの URL
session_last_view_id string 現在のセッションで最後にアクセスしたページの view_id
session_last_view_name string 現在のセッションの最後のページの URL

統計指標

フィールド タイプ 説明
time_spent number(ns) 現在のセッションの継続時間
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_referrer string ページの参照元。ページの親
view_name string ページ名
session_has_replay boolean 現在の View が属するセッションが Session Replay データに関連付けられているかどうか
app_state string SDK 1.6.8+:読み込み開始点(提供されていない場合は View 開始にフォールバック)から現在のスナップショットイベント時刻までのフォアグラウンド/バックグラウンド履歴に基づいてアプリケーション状態を計算します。値:foreground(フォアグラウンドのみ)、background(バックグラウンドのみ)、foreground_and_background(フォアグラウンドとバックグラウンドの両方を経由)、unknown(履歴欠落または区間無効)

指標

フィールド タイプ 説明
loading_time number(ns) ページ読み込み時間
interaction_to_next_view_time number(ns) SDK 1.6.8+:現在の View の開始時刻から、同一 Session 内で直前の View にある直近の有効な Action の開始時刻を減算した値;デフォルトでは click に一致し、間隔は [0,3秒] です。有効な Action がない場合、データがフィルタリングされた場合、またはフォールバック View に属する場合は出現しません;Session を跨いで関連付けられることはありません。欠落は 0 とは異なり、正当なゼロ所要時間は報告できます。マッチングルールと例 を参照してください
network_settled_time number(ns) SDK 1.6.8+:初期リクエストの最も遅い有効な終了時刻から View 開始時刻を減算した値(読み込み開始点ではありません);デフォルトでは View 開始後 [0,100ms] に開始されたリクエストを対象とし、ネットワークアイドルを 100ms 待つものではありません。完了済みバッチでは結果を生成・更新でき、後続の View スナップショットに現在値が含まれます。有効なリクエスト区間がない場合、データがフィルタリングされた場合、区間がバックグラウンドを跨ぐ場合、状態履歴がない場合、またはフォールバック View に属する場合は出現しません;欠落は 0 とは異なり、正当なゼロ所要時間は報告できます。マッチングルールと例 を参照してください
time_spent number(ns) ページ滞在時間
is_active boolean ユーザーがアクティブ状態かどうか。参考値:true & false
session_sample_rate number RUM Session のサンプリングレート
session_on_error_sample_rate number RUM Session サンプリングにヒットしなかった場合に、エラー発生後に追加サンプリングする際のサンプリングレート
session_replay_sample_rate number Session Replay のサンプリングレート。Session Replay 関連機能を有効化すると出現します
session_replay_on_error_sample_rate number エラー発生後に Session Replay を追加サンプリングする際のサンプリングレート。Session Replay 関連機能を有効化すると出現します
sampled_for_error_session boolean 現在の Session がエラーサンプリングポリシーによってサンプリングされたかどうか
sampled_for_error_replay boolean 現在の Session Replay がエラーサンプリングポリシーによってサンプリングされたかどうか
session_error_timestamp number(ns) エラーサンプリングにヒットした際のエラー発生日時
session_replay_stats object 現在の View に関連付けられた Session Replay 統計情報

統計指標

フィールド タイプ 説明
view_error_count number ページ読み込みごとに発生したエラー数
view_resource_count number ページ読み込みごとにリクエストされたリソース数
view_long_task_count number ページ読み込みごとに発生したロングタスク数
view_action_count number ページ閲覧中に操作した回数
view_update_time number View の更新回数
view_long_task_rate number View 期間中のロングタスク所要時間の割合

モニタリング指標

フィールド タイプ 説明
cpu_tick_count number 任意。このページの CPU ティック数
cpu_tick_count_per_second number 任意。1 秒あたりの平均 CPU ティック数
fps_avg number 任意。ページの平均 FPS
fps_mini number 任意。ページの最小 FPS
memory_avg number 任意。ページの平均メモリ使用量
memory_max number 任意。ページのメモリピーク値

Resource

View 属性

フィールド タイプ 説明
view_id string ページにアクセスするたびに生成される一意の ID
view_referrer string ページの参照元。ページの親
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーがページを操作したときに生成される一意の ID
action_name string 操作名
action_type string 操作タイプ(コールド/ホットスタート、click クリックなど)

Resource 属性

フィールド タイプ 説明
resource_url string リソース URL
resource_url_host string リソース URL のドメイン部分
resource_url_path string リソース URL の path 部分
resource_url_query string リソース URL の query 部分
resource_url_path_group string リソース URL の path グループ
resource_type string リソースのカテゴリ
resource_method string リソースリクエストのメソッド
resource_status string リソースリクエストが返すステータス値
resource_status_group string リソースリクエストが返すステータスグループ値
resource_host_ip string リソース URL のアクセス先 IP
resource_id string リソースリクエストの一意の ID
response_connection string レスポンスヘッダー Connection の値
response_content_type string レスポンスヘッダー Content-Type の値
response_content_encoding string レスポンスヘッダー Content-Encoding の値
span_id string トレースに関連付けられた span id
trace_id string トレースに関連付けられた trace id
session_has_replay boolean 現在の Resource が属するセッションが Session Replay データに関連付けられているかどうか
app_state string SDK 1.6.8+:収集側で正規化されたリクエスト開始から終了までの区間におけるフォアグラウンド/バックグラウンド履歴に基づいてアプリケーション状態を計算します。値:foreground(フォアグラウンドのみ)、background(バックグラウンドのみ)、foreground_and_background(フォアグラウンドとバックグラウンドの両方を経由)、unknown(履歴欠落または区間無効)

指標

フィールド タイプ 説明
resource_size number リソースサイズ。デフォルト単位:byte
resource_request_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)
resource_dns_time object DNS フェーズの所要時間。構造は {start, duration}
resource_connect_time object TCP 接続フェーズの所要時間。構造は {start, duration}
resource_first_byte_time object ファーストバイトフェーズの所要時間。構造は {start, duration}
resource_ssl_time object SSL フェーズの所要時間。構造は {start, duration}
resource_download_time object ダウンロードフェーズの所要時間。構造は {start, duration}
resource_redirect_time object リダイレクトフェーズの所要時間。構造は {start, duration}
resource_http_protocol string リソースリクエストで使用されるネットワークプロトコル
resource_connection_reuse boolean リソースリクエストで接続が再利用されたかどうか
request_header string リソースリクエストヘッダー
response_header string リソースレスポンスヘッダー

ネットワークスナップショット

フィールド タイプ 説明
network_available boolean Resource 開始時にネットワークが利用可能だったかどうか
network_signal_strength number SDK 1.6.9 以降でサポート。Resource の収集開始時のシステムリンク品質。マッピング:0 = unknown(不明)、1 = minimal(低)、2 = moderate(中)、3 = good(良好)。

network_signal_strength は iOS 26.0、tvOS 26.0、macOS 26.0 以降のシステムでのみサポートされます。サポートされていない場合、またはネットワーク状態をまだ取得できていない場合、このフィールドは報告されません。値はリンク品質レベルを表し、RSSI、dBm、システムの信号バー数を表すものではありません。

Error

View 属性

フィールド タイプ 説明
view_id string ページにアクセスするたびに生成される一意の ID
view_referrer string ページの参照元。ページの親
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーがページを操作したときに生成される一意の ID
action_name string 操作名

Error 属性

フィールド タイプ 説明
error_source string エラーソース。参考値:logger & network
error_type string エラータイプ
logger error type: anr_error | ios_crash
network error type:network_error
error_situation string エラー発生時のアプリケーション状態。参考値:startup(起動時)、run(実行時)、background(バックグラウンド)、unknown(不明)。SDK 1.6.9 以降、自動収集される ANR は報告時の状態ではなく、スタッタリング開始時の状態を保持します
session_has_replay boolean 現在の Error が属するセッションが Session Replay データに関連付けられているかどうか

type=network の場合、以下の Network Error 属性が追加されます。

フィールド タイプ 説明
resource_id string リソースリクエストの一意の ID
resource_status string リソースリクエストが返すステータス値
resource_url string リソース URL
resource_url_host string リソース URL のドメイン部分
resource_url_path string リソース URL の path 部分
resource_url_path_group string リソース URL の path グループ
resource_status_group string リソースリクエストが返すステータスグループ値
resource_method string リソースリクエストのメソッド

Error モニタリング属性

フィールド タイプ 説明
memory_total string 任意。メモリ総量
memory_use number 任意。メモリ使用率
cpu_use number 任意。CPU 使用率
battery_use number 任意。現在のモバイルデバイスのバッテリー残量(tvOS ではサポートされません)
carrier string 任意。通信事業者情報(iOS でサポート)
locale string 現在のシステム言語

指標

フィールド タイプ 説明
error_message string エラーメッセージ
error_stack string エラースタック
foreground_crash_free_duration number(ns) Crash 発生前にアプリケーションがフォアグラウンドにあったクラッシュなし継続時間
background_crash_free_duration number(ns) Crash 発生前にアプリケーションがバックグラウンドにあったクラッシュなし継続時間
crash_extra object Crash の追加情報(例:レジスタ情報)

Long Task

View 属性

フィールド タイプ 説明
view_id string ページにアクセスするたびに生成される一意の ID
view_referrer string ページの参照元。ページの親
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーがページを操作したときに生成される一意の ID
action_name string 操作名

指標

フィールド タイプ 説明
duration number(ns) スタッタリング時間
long_task_stack string スタッタリングスタック
session_has_replay boolean 現在の Long Task が属するセッションが Session Replay データに関連付けられているかどうか
app_state string SDK 1.6.8+:イベントの開始時刻と継続時間から区間を決定し、その区間内のフォアグラウンド/バックグラウンド履歴に基づいてアプリケーション状態を計算します。値:foreground(フォアグラウンドのみ)、background(バックグラウンドのみ)、foreground_and_background(フォアグラウンドとバックグラウンドの両方を経由)、unknown(履歴欠落または区間無効)

Action

View 属性

フィールド タイプ 説明
view_id string ページにアクセスするたびに生成される一意の ID
view_referrer string ページの参照元。ページの親
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーがページを操作したときに生成される一意の ID
action_name string 操作名。デフォルトの起動 Action には app_hot_start、app_cold_start、app_warm_start が含まれます
action_type string 操作タイプ。参考値:click、launch_hot、launch_cold、launch_warm
session_has_replay boolean 現在の Action が属するセッションが Session Replay データに関連付けられているかどうか

指標

フィールド タイプ 説明
duration number(ns) ページ操作の所要時間
app_pre_runtime_init_time object 起動フェーズ指標。ランタイム初期化前の所要時間。構造は {start, duration}
app_runtime_init_time object 起動フェーズ指標。ランタイム初期化の所要時間。構造は {start, duration}
app_uikit_init_time object 起動フェーズ指標。UIKit 初期化の所要時間。構造は {start, duration}
app_application_init_time object 起動フェーズ指標。Application 初期化の所要時間。構造は {start, duration}
app_first_frame_init_time object 起動フェーズ指標。初回フレーム描画の所要時間。構造は {start, duration}
app_launch_type string コールドスタートタイプ。action_type=launch_cold の場合にのみ報告されます。foreground:フォアグラウンド起動;background:バックグラウンド起動;SDK 1.6.9 以降では foreground_and_background をサポート:フォアグラウンド起動中にバックグラウンドへ切り替えられて中断された状態

統計指標

フィールド タイプ 説明
action_long_task_count number 操作に関連付けられたロングタスク数
action_resource_count number 操作に関連付けられたリソースリクエスト数
action_error_count number 操作に関連付けられたエラー数

WebView 連携

WebView JSBridge データを RUM に取り込む際、SDK は該当データに is_web_view=true を補完し、そのデータが WebView 由来であることを示します。WebView のデータフィールドは Web SDK が報告するフィールドを主体とし、native iOS のフィールド表ではこの連携説明のみを保持します。

フィードバック

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