コンテンツにスキップ

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

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

データタイプ

Guance のリアルユーザーモニタリング（RUM）には、次の 6 つのデータタイプがあります。

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

グローバル属性

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

SDK 属性

フィールド タイプ 説明
sdk_name string 収集器名、固定値：df_harmonyos_rum_sdk
sdk_version string 収集器のバージョン情報
sdk_pkg_info string SDK パッケージ情報（JSON 形式）

アプリケーション属性

フィールド タイプ 説明
app_id string 必須、RUM アプリケーションの一意の ID。Guance コンソールでモニターを作成する際に自動生成されます。
env string 必須、環境フィールド。属性値：prod/gray/pre/common/local。それぞれ：
prod：本番環境
gray：カナリア環境
pre：ステージング環境
common：開発環境
local：ローカル環境
version string 必須、バージョン番号。
service string オプション、所属する業務またはサービスの名前。固定値：df_rum_harmonyos
application_uuid string アプリケーションの一意識別子。同じビルドのアプリケーションでは UUID は同じになります。

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

フィールド タイプ 説明
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：ヘッドレス合成テストで生成されたデータ。
is_signin boolean 登録ユーザーかどうか。属性値：T & F。

デバイス & 解像度属性

フィールド タイプ 説明
device string モバイルデバイスのメーカー
model string モバイルデバイスのモデル
device_uuid string モバイルデバイスの一意の ID
os string オペレーティングシステム情報、固定値 HarmonyOS
os_version string オペレーティングシステムのバージョン
os_version_major string オペレーティングシステムのメジャーバージョン
screen_size string 画面解像度
arch string システムアーキテクチャ（例：aarch64）

地理 & ネットワーク属性

フィールド タイプ 説明
network_type string ネットワーク接続タイプ。属性値の参照：
wifi & 2g & 3g & 4g & 5g & unknown（不明なネットワーク）& unreachable（ネットワーク到達不能）

カスタム属性

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

その他のデータタイプ属性

Session

属性

フィールド タイプ 説明
session_id string セッション ID
session_type string セッションタイプ。参照値：user & test
user：RUM 機能で生成されたデータ
test：ヘッドレス合成テストで生成されたデータ。

View

属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意の ID
view_referrer string ページの参照元、親ページ
view_name string ページ名

メトリクス

フィールド タイプ 説明
loading_time number（ns） ページの読み込み時間
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 オプション、ページの平均フレームレート
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 操作名
action_type string 操作タイプ（コールド/ウォームスタート、クリックなど）

Resource 属性

フィールド タイプ 説明
resource_url string リソース URL
resource_url_host string リソース URL のドメイン部分
resource_url_path 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
trace_id string トレース ID（トレース有効時、オプション）
span_id string トレースのスパン ID（トレース有効時、オプション）
response_connection string 応答の接続タイプ（オプション）
response_content_type string 応答のコンテンツタイプ（オプション）
response_content_encoding 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） リソース読み込み時間
計算方法：duration(responseEnd - startTime)
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 エラータイプ：java_crash | native_crash | anr_error | anr_crash
network エラータイプ：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 のパス部分
resource_url_path_group string リソース URL のパスグループ
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 操作に関連するエラー数

フィードバック

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