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 のフィールド表ではこの連携説明のみを保持します。