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_sdkdf_linux_rum_sdkdf_windows_rum_sdkdf_web_rum_sdkdf_miniapp_rum_sdkdf_ios_rum_sdkdf_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_iosdf_rum_androiddf_rum_windowsdf_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 | 操作に関連付けられたエラーの数 |