Lade-Traces

Auf dieser Seite wird beschrieben, wie Sie mit der Winscope-Weboberfläche Protokolle laden.

Über die Web-UI hochladen

Sie können Winscope lokal ausführen oder über einen Webserver darauf zugreifen.

Wenn Sie aufgezeichnete Traces in Winscope laden möchten, verwenden Sie das Steuerfeld Traces hochladen, um gespeicherte Traces hochzuladen. Klicken Sie auf Weitere Datei hochladen, um weitere Traces hochzuladen, oder auf X, um hochgeladene Traces zu entfernen.

Traces in Winscope hochladen

Abbildung 1: Laden Sie die Traces in Winscope hoch.

Klicken Sie auf Traces anzeigen, um die hochgeladenen Traces aufzurufen. Oben im Fenster werden Tabs für jeden Trace angezeigt. Wenn die hochgeladene Datei die relevanten Informationen enthält, wird eine schwebende Ansicht des Bildschirmaufzeichnungs- oder Screenshot-Eintrags auf dem Bildschirm eingeblendet.

Weitere Informationen finden Sie unter Traces analysieren.

Warnungen und Fehler analysieren

In Winscope werden in einer Snackbar Probleme angezeigt, die beim Laden eines Tracings auftreten, z. B. wenn eine Tracingdatei verworfen wird, weil die Daten veraltet sind. In der folgenden Liste sind die aktuellen Warnungen und ihre Bedeutung aufgeführt:

Nachricht Beschreibung
Beschädigtes Archiv Die ZIP-Datei konnte nicht geladen werden. Das passiert in der Regel, wenn die ZIP-Datei leer ist (0 Byte).
<filename>: verworfen, da die Daten veraltet sind Alle Traces, die mehr als 5 Minuten vor Beginn des nächsten Traces enden, werden verworfen.
<filename>: verworfen, da die Daten älter als <time> sind Anhand des zuletzt gefundenen Offset für die Monotonie oder Bootzeit werden alle Spuren mit einem Offset von mehr als 5 Sekunden verworfen.
<filename>: von einer anderen Spur vom Typ <trace type> überschrieben Wenn sich in derselben Datei gleichwertige Protokolle (z. B. Protokoll und Dump) befinden, verwendet Winscope die folgenden Regeln:
  • Perfetto-Protokolle überschreiben ältere Protokolle desselben Typs.
  • Bildschirmaufzeichnungen überschreiben Screenshots.
<filename>: von einer anderen Spur desselben Typs überschrieben Wenn sich in derselben Datei Spuren desselben Typs befinden, gelten in Winscope die folgenden Regeln:
  • Perfetto-Protokolle überschreiben ältere Protokolle desselben Typs.
  • Die größte Perfetto-Spur überschreibt alle anderen Perfetto-Spuren.
  • Traces überschreiben Dumps für WindowManager und SurfaceFlinger.
<filename>: Nicht unterstütztes Format Der Legacy-Trace kann aufgrund eines ungültigen Proto oder eines fehlenden Winscope-Parsers nicht geparst werden.
<parser_name>-Parser konnte nicht erstellt werden: <error> Winscope hat den Trace-Parser erkannt, konnte die Datei aber nicht parsen. Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Nicht alle Spuren können visualisiert werden: Die Zeitachsendaten konnten nicht initialisiert werden. Versuchen Sie, einige Spuren zu entfernen.

Winscope konnte die Zeitachsendaten aus dem Trace nicht parsen. Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.

Bei der Framezuordnung ist ein Fehler aufgetreten: <error>

Winscope konnte die Status zwischen verschiedenen Spuren für die Navigation nicht zuordnen. Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.

Bei einem oder mehreren Einträgen in <table> fehlt der Wert für vsync_id Das Laden der Perfetto-Spur ist aufgrund fehlender Informationen zur VSync-ID fehlgeschlagen. Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Duplizierte SF-Ebenen-ID <layerId> gefunden – wird der Hierarchie als „Duplikat“ hinzugefügt Die SurfaceFlinger-Spur enthält zwei Ebenen mit derselben layerId. Reichen Sie einen SurfaceFlinger-Fehler ein und hängen Sie die Trace-Datei an.
Die Bildschirmaufzeichnung ist möglicherweise nicht mit den anderen Aufzeichnungen synchronisiert. Metadaten enthalten monotone Zeit statt verstrichene Zeit Die Bildschirmaufzeichnungsdatei ist alt und verwendet ein älteres Metadatenformat, das nicht synchronisiert werden kann. Bei Bildschirmaufzeichnungen mit neueren Android-Versionen sollte dieses Problem nicht auftreten.
Nicht alle Übergänge können geparst werden. Einige davon sind im Übergänge-Viewer möglicherweise nicht zu sehen. Der Trace für die alten Übergänge konnte nicht geparst werden. Daher fehlen im Viewer möglicherweise Daten.
<filename>: <error> Andere nicht zugeordnete Fehler Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.