トレースを読み込む

このページでは、Winscope のウェブ UI を使用してトレースを読み込む方法について説明します。

ウェブ UI を使用してアップロードする

ローカルで Winscope を実行するか、ウェブサーバーから Winscope にアクセスできます。

Winscope でキャプチャしたトレースを読み込むには、[Upload Traces] パネルを使用して保存済みのトレースをアップロードします。続けてトレースをアップロードするには [Upload another file] をクリックし、アップロードしたトレースを削除するには [X] をクリックします。

Winscope でトレースをアップロードする

図 1. Winscope でトレースをアップロードする

アップロードしたトレースを表示するには、[View traces] をクリックすると、各トレースのタブがウィンドウの上部パネルに表示されます。アップロードしたファイルに関連するトレースが含まれている場合、画面録画トレースまたはスクリーンショットのフローティング ビューが画面にオーバーレイされます。

詳しくは、トレースを分析するのページをご覧ください。

警告とエラーを解析する

Winscope ではスナックバーを使用して、トレースの読み込み時に検出された問題（データが古いためにトレース ファイルが削除された場合など）を表示します。以下のリストでは、現時点で表示される可能性がある警告とその内容をまとめています。

メッセージ 説明
アーカイブが破損しています ZIP ファイルの読み込みに失敗しました。これは通常 ZIP が空（0 バイト）の場合に発生します。
<filename>: データが古いため破棄しました 次のトレースが開始される 5 分以上前に終了したトレースは破棄されます。
<filename>: <time> 以上前のデータのため破棄しました 検出された最新の単調時間オフセットまたは起動時間オフセットに基づき、オフセットが 5 秒を超えるトレースは破棄されます。
<filename>: 別のタイプのトレース（<trace type>）によってオーバーライドされました 同等のトレース（トレースとダンプなど）が同じファイル内に存在する場合、Winscope では次のルールが適用されます。
  • Perfetto トレースは同じタイプの以前のトレースをオーバーライドする。
  • 画面録画はスクリーンショットをオーバーライドする。
<filename>: 同じタイプのトレースによってオーバーライドされました 同じタイプのトレースが同じファイル内に存在する場合、Winscope では次のルールが適用されます。
  • Perfetto トレースは同じタイプの以前のトレースをオーバーライドする。
  • 最も大きい Perfetto トレースが他のすべての Perfetto トレースをオーバーライドする。
  • トレースは WindowManager と SurfaceFlinger のダンプをオーバーライドする。
<filename>: サポートされていない形式です proto が無効であるか、Winscope パーサーがないために、以前のトレースを解析できません。
<parser_name> パーサーを作成できませんでした: <error> Winscope はトレース パーサーを特定したものの、ファイルを解析できませんでした。Winscope のバグを報告し、トレースを添付します。
すべてのトレースの可視化不可: タイムライン データの初期化に失敗したため、トレースをいくつか削除してください

Winscope はトレースからのタイムライン データの解析に失敗しました。Winscope のバグを報告し、トレースを添付します。
フレーム マッピングで次のエラーが発生しました: <error>

Winscope はナビゲーション用の異なるトレース間の状態のマッピングに失敗しました。Winscope のバグを報告し、トレースを添付します。
<table> の 1 つ以上のエントリで vsync_id 値が不足しています vsync ID 情報の不足により、Perfetto トレースの読み込みに失敗しました。Winscope のバグを報告し、トレースを添付します。
重複している SF レイヤ ID（<layerId>）が検出されました -「Duplicate（重複）」として階層に追加します SurfaceFlinger トレースに同じ layerId のレイヤが 2 つ含まれています。SurfaceFlinger のバグを報告し、トレースを添付します。
画面録画が他のトレースと同期されていない可能性があります。メタデータに経過時間ではなく単調時間が含まれています 画面録画ファイルが古く、同期できない以前のメタデータ形式が使用されています。新しいバージョンの Android の画面録画ではこの問題は発生しません。
すべての遷移を解析できません。遷移ビューアで一部の遷移が不足している可能性があります 以前の遷移トレースを解析できません。ビューアのデータが不足している可能性があります。
<filename>: <error> その他のマッピングされていないエラーを指します。Winscope のバグを報告し、トレースを添付します。