Flutter アプリケーションデータ収集
はじめに
Flutter のデータ収集は Android および iOS の Native フレームワークに依存しています。Android および iOS のデータ収集と比較するため、以下の取り消し線で示された項目は未実装の部分です。
データタイプ
Guance のリアルユーザーモニタリング(RUM)には 6 種類のデータタイプが含まれます。
| タイプ |
説明 |
| 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 |
コレクターのバージョン情報 |
アプリケーション属性
| フィールド |
タイプ |
説明 |
app_id |
string |
必須。ユーザーアクセスアプリケーションの一意の 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 |
ユーザー & セッション属性
| フィールド |
タイプ |
説明 |
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。 |
デバイス & 解像度属性
| フィールド |
タイプ |
説明 |
device |
string |
モバイルデバイスのメーカー |
model |
string |
モバイルデバイスのモデル |
device_uuid |
string |
モバイルデバイスの一意の ID。Android:ANDROID_ID、iOS:UIDevice.identifierForVendor を使用して生成されます |
os |
string |
オペレーティングシステム情報 |
os_version |
string |
オペレーティングシステムのバージョン |
os_version_major |
string |
オペレーティングシステムのメジャーバージョン |
screen_size |
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 はユーザーがカスタム tag データを付与することをサポートします)を使用してユースケースを構築し、イベントアラートを設定できます。カスタム属性は非グローバル属性です。カスタム属性を使用すると、ユーザーがアプリケーションにアクセスするプロセス全体を追跡し、ユーザーが影響を受けたアクセス状況を特定・発見し、ユーザーアクセスパフォーマンスを監視できます。
その他のデータタイプ属性
Session
属性
| フィールド |
タイプ |
説明 |
session_id |
string |
セッション id |
session_type |
string |
セッションタイプ。参考値:user & test user:RUM 機能によって生成されたデータ; test:ヘッドレス 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 |
ページ名 |
Action 属性
| フィールド |
タイプ |
説明 |
action_id |
string |
ユーザーがページを操作したときに生成される一意の ID |
action_name |
string |
操作名 |
action_type |
string |
操作タイプ(コールドスタート/ウォームスタート、クリックなど) |
メトリクス
| フィールド |
タイプ |
説明 |
loading_time |
number(ns) |
ページの読み込み時間。Flutter ページでは、手動で starView() を呼び出す前に createView(viewName, duration) を呼び出して設定できます。SDK 0.5.8 以降では、現在の View の開始後、終了前に updateViewLoadingTime(duration) を呼び出して更新することもできます。Flutter の自動ルーティングでは、業務の読み込み時間は自動測定されません |
network_settled_time |
number(ns) |
SDK 0.5.8 以降でサポートされます。初期ネットワークリクエストの所要時間:View の開始から、選択された初期 Resource の最も遅い有効終了までの時間間隔です。ネイティブのデフォルトマッチングルールを使用します。条件を満たす有効なリクエストがない場合は生成されません |
time_spent |
number(ns) |
ページ滞在時間 |
is_active |
boolean |
ユーザーがまだアクティブ状態かどうか。参考値:true & false |
統計メトリクス
| フィールド |
タイプ |
説明 |
view_error_count |
number |
ページを読み込むたびに発生したエラー数 |
view_resource_count |
number |
ページを読み込むたびにリクエストされたリソース数 |
view_long_task_count |
number |
ページを読み込むたびに生成されたロングタスク数 |
view_action_count |
number |
ページ閲覧中に操作された回数 |
監視メトリクス
| フィールド |
タイプ |
説明 |
cpu_tick_count |
number |
任意。このページの CPU ティック数 |
cpu_tick_count_per_second |
number |
任意。1 秒あたりの平均 CPU ティック数 |
fps_avg |
number |
任意。ページの 1 秒あたりの平均フレーム数 |
fps_mini |
number |
任意。ページの 1 秒あたりの最小フレーム数 |
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 |
操作タイプ(コールドスタート/ウォームスタート、クリックなど) |
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_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) |
リソース読み込み時間。startResource() / stopResource() で全体の所要時間を記録します |
request_header |
string |
リソースリクエストヘッダー |
response_header |
string |
リソースレスポンスヘッダー |
Error
View 属性
| フィールド |
タイプ |
説明 |
view_id |
string |
ページにアクセスするたびに生成される一意の ID |
view_referrer |
string |
ページの参照元、ページの親 |
view_name |
string |
ページ名 |
Action 属性
| フィールド |
タイプ |
説明 |
action_id |
string |
ユーザーがページを操作したときに生成される一意の ID |
action_name |
string |
操作名 |
action_type |
string |
操作タイプ(コールドスタート/ウォームスタート、クリックなど) |
Error 属性
| フィールド |
タイプ |
説明 |
error_source |
string |
エラーソース。参考値:logger & network |
error_type |
string |
エラータイプ logger error type: flutter_crash | java_crash | native_crash | anr_error | anr_crash | ios_crash network error type:network_error |
error_situation |
string |
エラーが発生したタイミング。参考値:startup(起動時)および run(実行時) |
type=network の場合、以下の Network Error 属性が追加されます。
| フィールド |
タイプ |
説明 |
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_method |
string |
リソースのリクエストメソッド |
Error 監視属性
| フィールド |
タイプ |
説明 |
memory_total |
string |
任意。総メモリ量 |
memory_use |
number |
任意。メモリ使用率 |
cpu_use |
number |
任意。CPU 使用率 |
battery_use |
number |
任意。現在の携帯電話のバッテリー量 |
locale |
string |
現在のシステム言語 |
メトリクス
| フィールド |
タイプ |
説明 |
error_message |
string |
エラーメッセージ |
error_stack |
string |
エラースタック |
Long Task
View 属性
| フィールド |
タイプ |
説明 |
view_id |
string |
ページにアクセスするたびに生成される一意の ID |
view_referrer |
string |
ページの参照元、ページの親 |
view_name |
string |
ページ名 |
Action 属性
| フィールド |
タイプ |
説明 |
action_id |
string |
ユーザーがページを操作したときに生成される一意の ID |
action_name |
string |
操作名 |
action_type |
string |
操作タイプ(コールドスタート/ウォームスタート、クリックなど) |
メトリクス
| フィールド |
タイプ |
説明 |
duration |
number(ns) |
スタッタリング時間 |
long_task_message |
string |
スタッタリング情報 |
long_task_stack |
string |
スタッタリングスタック |
Action
View 属性
| フィールド |
タイプ |
説明 |
view_id |
string |
ページにアクセスするたびに生成される一意の ID |
view_referrer |
string |
ページの参照元、ページの親 |
view_name |
string |
ページ名 |
Action 属性
| フィールド |
タイプ |
説明 |
action_id |
string |
ユーザーがページを操作したときに生成される一意の ID |
action_name |
string |
操作名 |
action_type |
string |
操作タイプ(コールドスタート/ウォームスタート、クリックなど) |
メトリクス
| フィールド |
タイプ |
説明 |
duration |
number(ns) |
ページ操作に費やした時間 |
統計メトリクス
| フィールド |
タイプ |
説明 |
action_long_task_count |
number |
操作に関連付けられたロングタスク数 |
action_resource_count |
number |
操作に関連付けられたリソースリクエスト数 |
action_error_count |
number |
操作に関連付けられたエラー数 |