ミニプログラムアプリケーションデータ収集¶
アプリケーションデータをGuanceに収集した後、Guanceコンソールでカスタム設定のシーンと異常検出イベントを設定できます。
データタイプ¶
Guanceのリアルユーザーモニタリング(RUM)は6つのデータタイプを含みます:
| タイプ | 説明 |
|---|---|
session |
ユーザーセッション情報の記録。現在のセッションでは、セッション次元に基づいてユーザーページ、リソース、操作、エラー、長いタスクのアクセスデータを記録します。 |
view |
ユーザーがページにアクセスするたびに、ページビューレコードが生成されます。ユーザーが同じページに留まっている場合、リソース、長いタスク、エラー、操作レコードは view_id 属性を介して関連する RUM ビューにリンクされます。 |
resource |
ユーザーがページにアクセスする際に読み込まれるリソース情報の記録。 |
error |
RUM 収集ツールはブラウザ上のすべてのフロントエンドエラーを収集します。 |
long_task |
ブラウザでメインスレッドを50ms以上ブロックするタスクに対して、長いタスクレコードが1件生成されます。 |
action |
ユーザーのページ閲覧中のすべてのユーザーインタラクション記録を追跡します。 |
グローバル属性¶
RUM のシーン構築とイベントアラートは、以下のグローバル属性を使用してクエリできます。
SDK 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
sdk_name |
string | 収集ツール名、固定値:df_web_rum_sdkdf_miniapp_rum_sdkdf_ios_rum_sdkdf_android_rum_sdk |
sdk_version |
string | 収集ツールのバージョン情報 |
アプリケーション属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
app_id |
string | 必須。RUM アプリケーションの一意の ID 識別子。Guanceコンソールでモニターを作成する際に自動生成されます。 |
env |
string | 必須。環境フィールド。属性値:prod/gray/pre/common/local。意味: prod:本番環境 gray:カナリア環境 pre:ステージング環境 common:日常環境 local:ローカル環境 |
version |
string | 必須。バージョン番号。 |
app_launch_query |
string | ミニプログラム起動時の query パラメータ。 |
app_launch_referrer_info |
string | 参照元情報。別のミニプログラム、公式アカウント、またはアプリからミニプログラムに進入する際に返されます。 |
詳細については、関連フィールドの説明を参照してください。
ユーザー & セッション属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
userid |
string | 未ログインユーザーは cookie を userid として使用し、ログインユーザーはアプリケーションのバックエンドで生成されたユーザー ID を使用します。 |
session_id |
string | セッション ID。 |
session_type |
string | セッションタイプ。参考値:user & synthetics user:RUM 機能によって生成されるデータ; synthetics:ヘッドレスブラウザテストによって生成されるデータ。 |
is_signin |
boolean | 登録ユーザーかどうか。属性値:True / False。 |
デバイス & 解像度属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
device |
string | モバイルデバイスのメーカー |
model |
string | モバイルデバイスのモデル |
device_uuid |
string | モバイルデバイスの一意の ID |
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 コード |
province |
string | 都道府県/省 |
city |
string | 市区町村 |
プラットフォーム & ライブラリバージョン属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
platform |
string | ミニプログラムが動作するアプリケーションプラットフォーム。例:微信ミニプログラムの platform は wechat |
platform_version |
string | ミニプログラムが動作するアプリケーションプラットフォームのバージョン |
app_framework_version |
string | ミニプログラムの基本バージョンライブラリ |
カスタム属性¶
グローバル属性以外にも、カスタム属性(SDK はユーザーがカスタムタグデータを設定可能)を使用してシーンを構築したり、イベントアラートを設定したりできます。カスタム属性は非グローバル属性であり、カスタム属性を使用することで、ユーザーがアプリケーションにアクセスする全過程を追跡し、ユーザーが影響を受けるアクセス状況を特定・発見し、ユーザーアクセスのパフォーマンスを監視できます。
その他のデータタイプ属性¶
Session¶
属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
session_id |
string | セッション ID |
session_type |
string | セッションタイプ。参考値:user & test user:RUM 機能によって生成されるデータ; test:ヘッドレスブラウザテストによって生成されるデータ。 |
session_referrer |
string | セッションの参照元。通常は参照元のページアドレスを記録します。 |
session_first_view_id |
string | 現在のセッションの最初のページの view_id |
session_first_view_name |
string | 現在のセッションの最初のページの名前 |
session_last_view_id |
string | 現在のセッションの最後にアクセスしたページの view_id |
session_last_view_name |
string | 現在のセッションの最後のページの名前 |
メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
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 | ページ URL |
performance_supported |
boolean | 現在のプラットフォームで Performance Observer が正常に購読されたかどうか |
first_render_supported |
boolean | 現在のプラットフォームに SDK が利用可能な初回レンダリング信号が存在するかどうか |
view_start_reason |
string | View 作成理由:page_load、page_show、または session_renewal |
メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
loading_time |
number(ns) | ページの navigation とライフサイクルで観測された最大読み込み時間 |
page_ready_time |
number(ns) | View 開始から onReady までの時間。page_fmp は互換性フィールド |
first_render_time |
number(ns) | 微信の firstRender.duration。抖音では first-paint - navigationStart。first_paint_time は互換性フィールド |
page_fp |
number(ns) | FP の現在のページの navigationStart からの相対時間 |
page_fcp |
number(ns) | FCP の現在のページの navigationStart からの相対時間 |
page_lcp |
number(ns) | 現在のページの最新の LCP の navigationStart からの相対時間 |
first_render_data_transfer_time |
number(ns) | 初回レンダリングの初期化データ転送時間 |
first_render_wait_time |
number(ns) | データ受信完了からビューレイヤーのレンダリング開始までの待機時間 |
first_render_view_layer_time |
number(ns) | ビューレイヤーの初回レンダリング時間 |
time_spent |
number(ns) | ページ滞在時間 |
onload_to_onshow |
number(ns) | ページの onload 時間から onshow までの時間 |
onshow_to_onready |
number(ns) | ページの onshow 時間から onready までの時間 |
ready_reached |
boolean | 現在のページのライフサイクルが onReady に達したかどうか |
first_render_reached |
boolean | 現在のページがプラットフォームの初回レンダリング信号を受信したかどうか |
ended_before_ready |
boolean | page_load View が終了する時点でまだ onReady に達していないかどうか |
ended_before_render |
boolean | 初回レンダリング信号をサポートする場合、page_load View が初回レンダリング前に終了したかどうか |
view_end_reason |
string | View 終了理由:onHide、onUnload、または session_renewal |
view_is_active |
boolean | View がまだアクティブ状態かどうか |
view_setdata_duration |
number(ns) | 現在の View の有効な setData 更新の累積時間 |
view_setdata_max_duration |
number(ns) | 単一の setData 更新の最大時間 |
view_setdata_pending_duration |
number(ns) | setData がキューに入ってから更新開始までの累積待機時間 |
view_setdata_update_duration |
number(ns) | setData の更新開始から終了までの累積実行時間 |
view_setdata_merged_count |
number | プラットフォームによってマージ処理された setData 更新の回数 |
is_active |
boolean | ユーザーがまだアクティブ状態かどうかを判断。参考値:true & false |
パフォーマンスフィールドのプラットフォーム口径、ホワイトスクリーン候補統計、および既知の境界については、パフォーマンス問題分析を参照してください。
統計メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
view_error_count |
number | ページ読み込みごとに発生したエラーの回数 |
view_resource_count |
number | ページ読み込みごとにリクエストされたリソースの数 |
view_long_task_count |
number | ページ読み込みごとに発生した長いタスクの回数 |
view_action_count |
number | ページビュー中の操作の回数 |
view_setdata_count |
number | ページの set_data 呼び出し回数 |
view_apdex_level |
number | ページの初回レンダリング |
Resource¶
View 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
view_id |
string | ページアクセスごとに生成される一意の ID |
view_referrer |
string | ページの参照元 |
view_name |
string | ページ URL |
Resource 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
resource_url |
string | リソース URL |
resource_url_host |
string | リソース URL のドメイン部分 |
resource_url_path |
string | リソース URL のパス部分 |
resource_url_query |
string | リソース URL のクエリ部分 |
resource_url_path_group |
string | リソース URL のパスグループ |
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) | リソース読み込み時間 計算方法:duration(responseEnd-startTime) |
Error¶
View 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
view_id |
string | ページアクセスごとに生成される一意の ID |
is_active |
boolean | ユーザーがまだアクティブ状態かどうかを判断。参考値: true & false |
view_referrer |
string | ページの参照元 |
view_name |
string | ページ URL |
Error 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
error_source |
string | エラーソース。参考値:console & network & source & custom |
error_type |
string | エラータイプ。参考リンク:error type |
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_message |
string | エラーメッセージ |
error_stack |
string | エラースタックトレース |
Long Task¶
View 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
view_id |
string | ページアクセスごとに生成される一意の ID |
is_active |
boolean | ユーザーがまだアクティブ状態かどうかを判断。参考値: true & false |
view_referrer |
string | ページの参照元 |
view_name |
string | ページ URL |
メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
duration |
number(ns) | ページ読み込み時に発生した長いタスクの所要時間 |
Action¶
View 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
view_id |
string | ページアクセスごとに生成される一意の ID |
is_active |
boolean | ユーザーがまだアクティブ状態かどうかを判断。参考値: true & false |
view_referrer |
string | ページの参照元 |
view_name |
string | ページ URL |
Action 属性¶
| フィールド | タイプ | 説明 |
|---|---|---|
action_id |
string | ユーザーのページ操作時に生成される一意の ID |
action_name |
string | 操作名 |
action_type |
string | 操作タイプ: 起動試行 - launch_attempt(view 関連情報なし) 起動 - launch(view 関連情報なし) ミニプログラムパッケージダウンロード - package_download(view 関連情報なし) スクリプトインジェクション - script_insert(view 関連情報なし) クリック - click など |
メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
duration |
number(ns) | ページ操作の所要時間 |
app_launch_attempt |
boolean | action_type=launch_attempt の場合は true。このイベントは duration に書き込まれません。 |
統計メトリクス¶
| フィールド | タイプ | 説明 |
|---|---|---|
action_long_task_count |
number | 操作に関連する長いタスクの回数 |
action_resource_count |
number | 操作に関連するリソースリクエストの回数 |
action_error_count |
number | 操作に関連するエラーの回数 |