コンテンツにスキップ

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

フィードバック

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