コンテンツにスキップ

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 を使用します。
user_name string オプション。ユーザー名。
user_email string オプション。ユーザーのメールアドレス。
session_id string セッション ID。15 分以上操作がないと、新しい session_id が生成されます。
session_type string セッションタイプ。参考値：user & synthetics
user：RUM 機能によって生成されたデータ
synthetics：ヘッドレス Synthetic テストによって生成されたデータ
is_signin boolean 登録ユーザーかどうか。属性値：T & F。
session_has_replay boolean 現在のセッションがセッションリプレイデータに関連付けられているかどうか。

デバイス & 解像度属性

フィールド 型 説明
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 コード
province string 省
city string 都市

カスタム属性

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

その他のデータ型の属性

Session

Session 関連データは、サーバー側のセッション粒度で集計されたデータであり、Android SDK がネイティブで直接報告するメジャーメントではありません。

属性

フィールド 型 説明
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 ページ名

指標

フィールド 型 説明
loading_time number（ns） ページ読み込み時間
time_spent number（ns） ページ滞在時間
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 現在のセッションがエラーセッションリプレイのサンプリング対象かどうか。参考値：true & false
session_error_timestamp number（ns） セッションがエラーサンプリングをトリガーした際のエラー発生時刻

統計指標

フィールド 型 説明
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）
fps_mini number オプション。ページの最小フレームレート（FPS）
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 のパス部分
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_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）スパン ID
trace_id string アプリケーションパフォーマンスモニタリング（APM）トレース ID
session_has_replay boolean 現在のリソースがセッションリプレイデータに関連付けられているかどうか

指標

フィールド 型 説明
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 エラータイプ: java_crash | native_crash | anr_error | anr_crash
network エラータイプ：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 のパス部分
resource_url_path_group string リソース URL のパスグループ
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 現在の長期間タスクがセッションリプレイデータに関連付けられているかどうか

Action

View 属性

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

Action 属性

フィールド 型 説明
action_id string ユーザーのページ操作時に生成される一意の ID
action_name string 操作名
action_type string 操作タイプ（コールド/ホット起動、クリックなどの操作）
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 現在の操作がセッションリプレイデータに関連付けられているかどうか

統計指標

フィールド 型 説明
action_long_task_count number 操作に関連付けられた長期間タスクの数
action_resource_count number 操作に関連付けられたリソースリクエストの数
action_error_count number 操作に関連付けられたエラーの数

フィードバック

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