כדי לטעון עקבות שתועדו ב-Winscope, משתמשים בחלונית Upload Traces כדי להעלות את העקבות השמורים. לוחצים על העלאת קובץ נוסף כדי להעלות עוד מעקבים, או על X כדי להסיר מעקבים שהועלו.
איור 1. מעלים את העקבות ב-Winscope.
לוחצים על הצגת הטראסים כדי להציג את הטראסים שהועלו. הכרטיסיות של כל מעקב מופיעות בחלונית העליונה של החלון. אם הקובץ שהעליתם מכיל את הנתונים הרלוונטיים, תופיע על המסך תצוגה צפה של צילום המסך או של הנתונים של הקלטת המסך.
ב-Winscope מוצגת סרגלית כדי להציג בעיות שנמצאו בזמן טעינת המעקב, למשל כשקובץ מעקב מסוים נמחק כי הנתונים בו ישנים. הרשימה הבאה כוללת את האזהרות הנוכחיות ואת המשמעות שלהן:
הודעה
תיאור
ארכיון פגום
טעינת קובץ ה-zip נכשלה. בדרך כלל זה קורה כשקובץ ה-zip ריק (0 בייטים).
<filename>: הנתונים הוסרו כי הם ישנים
כל הטראסים שמסתיימים יותר מ-5 דקות לפני תחילת הטראס הבא נמחקים.
<filename>: הנתונים הוסרו כי הם ישנים יותר מ-<time>
על סמך ההיסט המונוטוני או העדכון האחרון שנמצא בזמן האתחול, כל עקבות עם היסט של יותר מ-5 שניות יידחו.
<filename>: נעקף על ידי נתיב אחר מסוג <trace type>
כשיש באותו קובץ מעקבים מקבילים (לדוגמה, מעקב ו-dump), Winscope משתמש בכללים הבאים:
נתוני המעקב של Perfetto מבטלים את נתוני המעקב הקודמים מאותו סוג.
הקלטות מסך מבטלות צילומי מסך.
<filename>: הוחלפה על ידי נתיב אחר מאותו סוג
כשיש עקבות מאותו סוג באותו קובץ, Winscope משתמש בכללים הבאים:
נתוני המעקב של Perfetto מבטלים את נתוני המעקב הקודמים מאותו סוג.
הנתיב הארוך ביותר ב-Perfetto מבטל את כל שאר הנתיבים ב-Perfetto.
נתוני המעקב מבטלים את נתוני הדימפ של WindowManager ו-SurfaceFlinger.
<filename>: פורמט לא נתמך
לא ניתן לנתח את המעקב הקודם בגלל פרוטוקול לא תקין או מנתח Winscope חסר.
Failed to create <parser_name> parser:
<error>
Winscope זיהה את מנתח המעקב אבל לא הצליח לנתח את הקובץ.
דיווח על באג ב-Winscope וחיבור של נתוני המעקב
לא ניתן להציג את כל העקבות: לא ניתן לאתחל את נתוני ציר הזמן.
כדאי לנסות להסיר חלק מהעקבות.
Winscope לא הצליח לנתח את נתוני ציר הזמן מהמעקב. דיווח על באג ב-Winscope וחיבור המעקב
אירעה שגיאה במיפוי המסגרת: <error>
ל-Winscope לא הצליח למפות את המצבים בין נתוני מעקב שונים לניווט. דיווח על באג ב-Winscope וחיבור המעקב
חסר ערך vsync_id ברשומה אחת או יותר ב-<table>
טעינת המעקב של Perfetto נכשלה כי חסרים פרטי מזהה VSync.
דיווח על באג ב-Winscope וחיבור המעקב
נמצא מזהה שכבת SF כפול <layerId> – הוספה שלו להיררכיה בתור כפילות
המעקב אחרי SurfaceFlinger מכיל שתי שכבות עם אותו layerId.
דיווח על באג ב-SurfaceFlinger וחיבור המעקב
יכול להיות שהקלטת המסך לא תסתנכרן עם שאר העקבות.
המטא-נתונים מכילים זמן מונוטוני במקום זמן חולף
קובץ הקלטת המסך ישן ומשתמש בפורמט מטא-נתונים מדור קודם שלא ניתן לסנכרן. סרטוני מסך מגרסאות חדשות יותר של Android לא אמורים לכלול את הבעיה הזו.
לא ניתן לנתח את כל המעברים. יכול להיות שחלק מהן לא יופיעו ב'תצוגת המעבר'.
לא ניתן לנתח את המעקב אחר המעברים מהדור הקודם, יכול להיות שיהיו נתונים חסרים בתצוגה.
<filename>: <error>
שגיאות אחרות שלא מותאמות. דיווח על באג ב-Winscope וחיבור הטראס
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Load traces\n\nThis page describes how to load traces using the Winscope Web UI.\n\nUpload using the web UI\n-----------------------\n\nYou can [run Winscope](/docs/core/graphics/winscope/run) locally or access it from a web server.\n\nTo load [captured traces](/docs/core/graphics/winscope/capture/overview) in Winscope, use the **Upload Traces** panel to\nupload saved traces. Click **Upload another file** to upload more traces or\nclick **X** to remove uploaded traces.\n\n**Figure 1.** Upload traces in Winscope.\n\nClick **View traces** to view the uploaded traces. Tabs for each trace\nappear on the top panel of the window. If the uploaded file contains the\nrelevant traces, a floating view of the screen recording trace or screenshot is\noverlaid on the screen.\n\nSee [Analyze traces](/docs/core/graphics/winscope/analyze/overview) for more information.\n| **Note:** The supported trace file types are Winscope traces (in Perfetto or legacy proto format), screenshots, MP4 videos with Winscope metadata (collected with adb screenrecord), zip files, gzip file, and bug reports.\n\nParse warnings and errors\n-------------------------\n\nWinscope uses a snackbar to display issues found when loading a trace, such as\nwhen a trace file is discarded because the data is old. The following list\nincludes the current warnings and their meanings:\n\n| Message | Description |\n|-----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| *corrupted archive* | Failed to load the zip file. This usually happens when the zip is empty (0 bytes). |\n| *`\u003cfilename\u003e`: discarded because data is old* | Any traces that finish more than 5 minutes before the next trace starts are discarded. |\n| *`\u003cfilename\u003e`: discarded because data is older than `\u003ctime\u003e`* | Based on the most recent monotonic or boot time offset found, any traces with an offset greater than 5 seconds are discarded. |\n| *`\u003cfilename\u003e`: overridden by another trace of type `\u003ctrace type\u003e`* | When equivalent traces (for example, trace and dump) exist in the same file, Winscope uses the following rules: - Perfetto traces override legacy traces of the same type. - Screen recordings override screenshots. |\n| *`\u003cfilename\u003e`: overridden by another trace of same type* | When traces of the same type exist in the same file, Winscope uses the following rules: - Perfetto traces override legacy traces of same type. - The largest Perfetto trace overrides all other Perfetto traces. - Traces overrides dumps for WindowManager and SurfaceFlinger. |\n| *`\u003cfilename\u003e`: unsupported format* | The legacy trace can't be parsed due to an invalid proto or missing Winscope parser. |\n| *Failed to create `\u003cparser_name\u003e` parser: `\u003cerror\u003e`* | Winscope identified the trace parser but couldn't parse the file. *File a Winscope bug and attach your trace.* |\n| *Cannot visualize all traces: Failed to initialize timeline data. Try removing some traces.* | Winscope failed to parse timeline data from the trace. *File a Winscope bug and attach your trace*. |\n| *Error occurred in frame mapping: `\u003cerror\u003e`* | Winscope failed to map the states between different traces for navigation. *File a Winscope bug and attach your trace*. |\n| *Missing `vsync_id` value for one or more entries in `\u003ctable\u003e`* | Failed to load Perfetto trace due to missing VSync ID information. *File a Winscope bug and attach your trace*. |\n| *Duplicate SF layer ID `\u003clayerId\u003e` found - adding it as **Duplicate** to the hierarchy* | SurfaceFlinger trace contains two layers with the same `layerId`. *File a SurfaceFlinger bug and attach your trace*. |\n| *Screen recording may not be synchronized with the other traces. Metadata contains monotonic time instead of elapsed* | The screen recording file is old and uses legacy metadata format that can't be synchronized. Screen recordings from newer versions of Android shouldn't have this issue. |\n| *Cannot parse all transitions. Some may be missing in Transitions viewer.* | Unable to parse the legacy transitions trace, data might be missing from the viewer. |\n| *`\u003cfilename\u003e`: `\u003cerror\u003e`* | Other unmapped errors. *File a Winscope bug and attach your trace*. |"]]
