このページでは、Winscope のウェブ UI を使用してトレースを読み込む方法について説明します。
ウェブ UI を使用してアップロードする
ローカルで Winscope を実行するか、ウェブサーバーから Winscope にアクセスできます。
Winscope でキャプチャされたトレースを読み込むには、[トレースのアップロード] パネルを使用して保存済みのトレースをアップロードします。続けてトレースをアップロードするには [別のファイルをアップロード] をクリックし、アップロードしたトレースを削除するには [X] をクリックします。
図 1. Winscope でトレースをアップロードする。
アップロードされたトレースを表示するには、[トレースを表示] をクリックします。各トレースのタブがウィンドウの上部パネルに表示されます。アップロードされたファイルに関連するトレースが含まれている場合、画面録画トレースまたはスクリーンショットのフローティング ビューが画面にオーバーレイされます。
詳しくは、トレースを分析するをご覧ください。
警告とエラーを解析する
Winscope ではスナックバーを使用してトレースの読み込み時に検出された問題（データが古いためにトレース ファイルが削除されるなど）を表示します。現在の警告とそれぞれの意味のリストを以下に示します。
| メッセージ | 説明 |
|---|---|
| アーカイブが破損しています | ZIP ファイルの読み込みに失敗しました。これは通常、zip が空（0 バイト）の場合に発生します。 |
<filename>: データが古いため破棄しました |
次のトレースが開始される 5 分以上前に終了したトレースは破棄されます。 |
<filename>: <time> 以上前のデータのため破棄しました |
検出される最新の単調時間オフセットまたは起動時間オフセットを基に、オフセットが 5 秒を超えるトレースは破棄されます。 |
<filename>: 別の種類のトレース <trace type> によってオーバーライドされました |
同等のトレース（トレースとダンプなど）が同じファイル内に存在する場合、Winscope では次のルールが使用されます。
|
<filename>: 同じ種類の別のトレースによってオーバーライドされました |
同じ種類のトレースが同じファイル内に存在する場合、Winscope では次のルールが使用されます。
|
<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 のバグを報告し、トレースを添付します。 |