コンテンツにスキップ

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


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

データタイプ

Guanceのリアルユーザーモニタリング(RUM)には 6 種類のデータタイプがあります。そのうち Android SDK は view、resource、error、long_task、action の 5 種類のデータをネイティブに直接送信し、session はセッション単位で集約されたデータです。

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

グローバル属性

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

SDK 属性

フィールド タイプ 説明
sdk_name string コレクター名。固定名称:
df_macos_rum_sdk
df_linux_rum_sdk
df_windows_rum_sdk
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk
sdk_version string コレクターのバージョン情報
sdk_pkg_info string コレクターのバージョン情報セット。SDK 内部モジュールのバージョン情報を含みます。

アプリケーション属性

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

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

フィールド タイプ 説明
userid string 未ログインユーザーはランダム UUID を userid として使用し、ログインユーザーはアプリケーションバックエンドで生成されたユーザー ID を使用します。
visitor_id string 任意。SDK が自動生成する匿名ビジター識別子。デフォルトでは無効で、FTRUMConfig.setVisitorIdConfig(...) で有効な設定を渡すと、ネイティブ RUM データにこのフィールドが関連付けられます。プロセス単位で永続化され、デフォルトの有効期限は 24 時間で、FTSdk.resetVisitorId() で能動的にリセットできます。詳細はビジター識別子 Visitor IDを参照してください。
user_name string 任意。ユーザー名。
user_email string 任意。ユーザーメール。
session_id string セッション ID。15 分以上操作がない場合、新しい session_id が生成されます。
session_type string セッションタイプ。参考値:user & synthetics
user:RUM 機能によって生成されたデータ;
synthetics:headless テストによって生成されたデータ。
is_signin boolean 登録ユーザーかどうか。属性値:T & F。
session_has_replay boolean 現在のセッションが Session Replay データに関連付けられているかどうか。

デバイス & 解像度属性

フィールド タイプ 説明
device string モバイルデバイスの製造元
model string モバイルデバイスのモデル
device_uuid string モバイルデバイスの一意な ID。ANDROID_ID を使用して生成
os string オペレーティングシステム情報
os_version string オペレーティングシステムのバージョン
os_version_major string オペレーティングシステムのメジャーバージョン
screen_size string 画面解像度
arch 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 関連データはサーバー側のセッション単位で集約されたデータであり、Android SDK がネイティブに直接送信する measurement ではありません。

属性

フィールド タイプ 説明
session_id string セッション ID
session_type string セッションタイプ。参考値:user & synthetics
user:RUM 機能によって生成されたデータ;
synthetics:headless テストによって生成されたデータ。
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 ページ名

メトリクス

フィールド タイプ 説明
loading_time number(ns) ページ読み込み時間
time_spent number(ns) ページ滞在時間
network_settled_time number(ns) View の開始から、選択された初期 Resource の最も遅い終了までの間隔。
デフォルトでは、この View 配下で Resource 開始時間 - View 開始時間 < 100 ms を満たすすべてのリクエストが選択され、ちょうど 100 ms は含まれません。「初期 Resource」はリクエストの集合であり、最初のリクエストではありません。
interaction_to_next_view_time number(ns) 新しい View の開始時間から、前の View の最後の有効なインタラクション時間を引いた値。結果は新しい View に書き込まれます。
デフォルトでは、時間差が厳密に 0 より大きく 3000 ms 未満であることが要求され、0 または 3000 ms に等しい場合はこのフィールドは生成されません。
is_active boolean ユーザーがまだアクティブ状態かどうか。参考値:true & false
session_sample_rate number RUM セッションのサンプリングレート
session_on_error_sample_rate number エラーセッションのサンプリングレート
sampled_for_error_session boolean 現在のセッションがエラーサンプリングセッションかどうか。参考値:true & false
sampled_for_error_replay boolean 現在のセッションがエラー Session Replay サンプリングかどうか。参考値:true & false
session_error_timestamp number(ns) セッションがエラーサンプリングをトリガーした際のエラー発生時間

network_settled_time と interaction_to_next_view_time はネイティブ View にのみ適用され、WebView 内の Browser SDK のメトリクス計算は変更されません。

network_settled_time は、ファーストビューの描画完了やページの操作可能状態を表すものではありません。リクエスト終了後もデータ処理や描画が必要な場合があり、デフォルトのウィンドウ外で開始されたリクエストも計算に含まれません。例えば、2 つの初期リクエストがそれぞれ View 開始後の 150 ms と 400 ms に終了した場合、書き込み条件を満たした後、このフィールドは 400000000 となり、2 つのリクエストの所要時間の合計にはなりません。

時間ウィンドウの調整、カスタム判定条件、またはメトリクスの無効化が必要な場合は、View 所要時間メトリクスのカスタムルールを参照してください。

統計メトリクス

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

モニタリングメトリクス

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

Resource

View 属性

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

Action 属性

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

Resource 属性

フィールド タイプ 説明
resource_url string リソース URL
resource_id string リソースの一意な ID
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
response_connection string リソースレスポンスヘッダー Connection の値
response_content_type string リソースレスポンスヘッダー Content-Type の値
response_content_encoding string リソースレスポンスヘッダー Content-Encoding の値
resource_http_protocol string リソースリクエストで使用される HTTP プロトコル
resource_connection_reuse boolean リソースリクエストが接続を再利用したかどうか
span_id string APM リンク Span ID
trace_id string APM リンク Trace ID
session_has_replay boolean 現在のリソースが Session Replay データに関連付けられているかどうか

メトリクス

フィールド タイプ 説明
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)
resource_request_size number リソースリクエストサイズ。デフォルト単位:byte
resource_dns_time object リソースの DNS 解決時間。形式:{duration: number(ns), start: number(ns)}
resource_connect_time object リソース接続所要時間。形式は resource_dns_time と同じ
resource_first_byte_time object リソース読み込みの初回パケット時間。形式は resource_dns_time と同じ
resource_ssl_time object リソース SSL 接続所要時間。形式は resource_dns_time と同じ
resource_download_time object リソースダウンロード所要時間。形式は resource_dns_time と同じ
request_header string リソースリクエストヘッダー
response_header string リソースレスポンスヘッダー

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

フィールド タイプ 説明
network_available boolean リソースリクエスト開始時にネットワークが利用可能かどうか
network_validated boolean リソースリクエスト開始時にネットワークがシステムによって検証済みかどうか
network_downlink_kbps number リソースリクエスト開始時のネットワーク下り帯域幅。単位:kbps
network_uplink_kbps number リソースリクエスト開始時のネットワーク上り帯域幅。単位:kbps
network_signal_strength number リソースリクエスト開始時のネットワーク信号強度

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: java_crash | native_crash | anr_error | anr_crash
network error type:network_error
error_situation string エラー発生のタイミング。参考値:startup(起動時)と run(実行時)

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

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

Error モニタリング属性

フィールド タイプ 説明
memory_total string 任意。メモリ総量
memory_use number 任意。メモリ使用率
cpu_use number 任意。CPU 使用率
battery_use number 任意。現在の携帯電話のバッテリー残量
carrier string 任意。モバイルセルラー通信事業者
locale string 現在のシステム言語

メトリクス

フィールド タイプ 説明
error_message string エラーメッセージ
error_stack string エラースタック
foreground_crash_free_duration number(ns) フォアグラウンドでのクラッシュなし継続時間
background_crash_free_duration number(ns) バックグラウンドでのクラッシュなし継続時間

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 現在のロングタスクが Session Replay データに関連付けられているかどうか

Action

View 属性

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

Action 属性

フィールド タイプ 説明
action_id string ユーザーがページ操作時に生成される一意な ID
action_name string 操作名
action_type string 操作タイプ(コールド/ホット起動、click タップなどの操作)
app_launch_type string コールド起動 Action の起動タイプ。参考値:foreground(フォアグラウンド起動)と background(バックグラウンド起動)。ft-sdk 1.7.2 以上のバージョンでサポート

メトリクス

フィールド タイプ 説明
duration number(ns) ページ操作にかかった時間
app_pre_application_init_time object コールド起動時、プロセス起動から Application.onCreate() までの初期化所要時間。形式:{duration: number(ns), start: number(ns)}
app_application_init_time object コールド起動時、Application.onCreate() から最初の Activity の preOnCreate() までの初期化所要時間。形式は app_pre_application_init_time と同じ
app_first_frame_init_time object コールド起動時、最初の Activity の preOnCreate() から初回フレーム描画完了までの所要時間。形式は app_pre_application_init_time と同じ
session_has_replay boolean 現在の操作が Session Replay データに関連付けられているかどうか

統計メトリクス

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

フィードバック

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