コンテンツにスキップ

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

アプリケーションデータをGuanceに取り込んだ後、Guanceコンソールでシナリオのカスタム設定や異常検知イベントの設定を行うことができます。

データ型

Guanceのリアルユーザーモニタリング（RUM）には、次の6種類のデータ型があります：

タイプ 説明
session ユーザーセッション情報の記録です。現在のセッションでは、セッション単位でユーザーのページ、リソース、操作、エラー、ロングタスクに関連するアクセスデータを収集します。
view ユーザーがモバイルアプリのページにアクセスするたびに、ビューレコードが1件生成されます。ユーザーが同じページに留まっている間、リソース、ロングタスク、エラー、操作のレコードは 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 必須。ユーザーがアクセスするアプリの一意の ID です。Guanceコンソールでモニターを作成すると自動生成されます。
env string 必須。環境フィールドです。属性値：prod/gray/pre/common/local。内訳：
prod：本番環境
gray：カナリア環境
pre：プリリリース環境
common：通常環境
local：ローカル環境
version string 必須。バージョン番号。
service string 任意。所属するビジネスまたはサービスの名前。固定名：df_rum_harmonyos
application_uuid string アプリの一意の識別子。同じ Build のアプリは 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：headless Synthetic テストで生成されたデータ
is_signin boolean 登録ユーザーかどうか。属性値：T & F。

デバイス & 解像度属性

フィールド タイプ 説明
device string モバイルデバイスのメーカー
model string モバイルデバイスのモデル
device_uuid string モバイルデバイスの一意の ID
os string OS情報。固定値：HarmonyOS
os_version string OSバージョン
os_version_major string OSメジャーバージョン
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：headless Synthetic テストで生成されたデータ

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 任意。ページの1秒あたりの平均フレーム数
fps_mini number 任意。ページの1秒あたりの最小フレーム数
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_id string Resource の安定した一意の ID
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 分散型トレーシング Span 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_id string 対応する Resource の安定した一意の ID
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 操作タイプ（例：click、launch_cold）
app_launch_type string コールドスタート Action の起動タイプ。参考値：foreground（フォアグラウンド起動）、background（バックグラウンドからの復帰後、初めて UI を表示）。ft-sdk 0.1.17 以降でサポートされています

メトリクス

フィールド タイプ 説明
duration number（ns） ページ操作にかかった時間
app_pre_application_init_time object コールドスタート時に、プロセス起動からアプリ初期化までのフェーズ。形式：{start: number(ns), duration: number(ns)}
app_application_init_time object コールドスタート時に、アプリ初期化から最初の UIAbility の作成までのフェーズ。形式は上記と同じ
app_first_frame_init_time object コールドスタート時に、最初の UIAbility の作成から最初のレンダリングフレームまでのフェーズ。形式は上記と同じ

統計メトリクス

フィールド タイプ 説明
action_long_task_count number 操作に関連するロングタスク数
action_resource_count number 操作に関連するリソースリクエスト数
action_error_count number 操作に関連するエラー数

フィードバック

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