ミニプログラムのパフォーマンス問題分析¶

本ドキュメントでは、@cloudcare/rum-miniapp 2.2.18 以降で収集されるページパフォーマンスフィールドと、それらを用いて初回レンダリングの遅延やページ終了前の未レンダリングなど、ホワイトスクリーンが疑われる問題を特定する方法について説明します。すべての所要時間フィールドは、Guanceに報告された後、ナノ秒（ns）に統一されます。

収集範囲¶

SDK は以下のパフォーマンスシグナルを収集できます。

• ページロード、onReady、初回レンダリング、FP、FCP、LCP
• ページ終了時に onReady またはプラットフォームの初回レンダリングシグナルがトリガーされたかどうか
• setData の回数、累計所要時間、最大所要時間、キューイング時間、更新時間、マージ回数
• 起動試行、ネイティブ起動、スクリプト実行、コードパッケージダウンロード
• 遅いページに関連する Resource および Error データ

SDK はスクリーンショットを収集せず、ビジネススケルトン画面以降のコアコンテンツが利用可能かどうかを判断することもできません。したがって、特定のパフォーマンスフィールドが欠落していることをもって、直ちにホワイトスクリーンと断定することはできません。

プラットフォームパフォーマンスデータ¶

SDK は、ミニプログラムプラットフォームが提供する Performance API を優先的に使用します。Observer が正常にサブスクライブされると performance_supported=true となり、プラットフォームが利用可能な初回レンダリングシグナルも同時に提供する場合、first_render_supported=true となります。

WeChat ミニプログラム¶

WeChat 形式の entry は、以下の指標に直接マッピングされます。

コールドスタート時の appLaunch と通常の route navigation は、どちらも初回画面のページ ID を確立できます。SDK は route、pageId、および最新の navigationStart に基づいて現在のページインスタンスを選択します。paint が navigation より先に到着した場合は一時的に保存され、entry の絶対 startTime が所要時間として誤って扱われるのを防ぎます。

Douyin ミニプログラム¶

Douyin は paint、evaluate、navigation、resource、launch の entry を使用します。SDK はこれらをまず統一された基準に変換します。

Douyin には WeChat のような firstRender entry がないため、SDK は現在のページの first-paint - navigationStart をそのプラットフォームにおける初回レンダリングシグナルとして使用します。この基準は FCP やビジネスコンテンツの利用可能性と同等ではありません。

View パフォーマンスフィールド¶

機能とライフサイクル属性¶

ended_before_render は first_render_supported=true の場合にのみ統計的に意味を持ちます。セッション更新は RUM View を分割するだけで、ページの再読み込みを意味するわけではないため、ページの早期終了という結論は生成されません。

レンダリング所要時間¶

first_paint_time と first_render_time は互換性フィールドであり、どちらも SDK が選択した初回レンダリングシグナルを示します。実際の FP を分析する必要がある場合は page_fp を使用してください。

setData 所要時間¶

SDK は、listener がインストールされた時点の所属ページを記録します。非表示ページや古いコンポーネントからの遅延コールバックは現在の View にカウントされず、ページのアンロードやコンポーネントの分離後はリスニングが停止されます。

起動段階の指標¶

起動段階は action データとして報告されます。

後者の 3 つはプラットフォームの Performance entry に依存します。launch / launch_attempt の比率を使用してネイティブ起動指標のカバレッジを観察することを推奨します。entry がないことを所要時間ゼロと見なさないでください。

ホワイトスクリーン候補の統計¶

ホワイトスクリーン分析は、カバレッジ、遅延レンダリング、早期終了の 3 つのカテゴリの指標に分割することを推奨します。

統計サンプル¶

まず以下の条件でフィルタリングします。

view_start_reason = page_load
performance_supported = true
first_render_supported = true

初回レンダリングシグナルをサポートしていないプラットフォームは、カバレッジを個別に統計し、ended_before_render の分母には含めないでください。

推奨基準¶

推奨ダッシュボードには、少なくとも以下を含めてください。

1. Performance と初回レンダリングシグナルのカバレッジ
2. FP、FCP、LCP、firstRender の P50、P75、P95
3. ended_before_render、ended_before_ready の比率
4. 遅い View の Error、失敗 Resource、5xx、TTFB の分布
5. アプリケーションバージョン、プラットフォーム、OS、デバイスモデルごとに分類したトレンド

既知の制限事項¶

• SDK にはビジネス的な markViewReady() API がなく、コアビジネスコンテンツが利用可能であることを確認できません。
• Page onLoad 前に発生した致命的なエラーには View Context がない可能性があります。
• 現時点では Long Task、FPS、ページフリーズ、スクリーンショットは収集されません。
• プラットフォームの Performance API、基本ライブラリ、OS バージョンの違いにより、フィールドのカバレッジに影響が出る可能性があります。
• データ送信失敗時のリトライやローカル永続化がない場合、ネットワーク環境が悪いと問題の比率が過小評価される可能性があります。

公式リファレンス¶

• WeChat ミニプログラム PerformanceEntry
• WeChat ミニプログラムパフォーマンスデータ
• WeChat ミニプログラム setData パフォーマンス
• Douyin ミニプログラム createObserver
• Douyin ミニプログラム PerformanceEntry