查看系統設定檔

在 Android GPU Inspector (AGI) 中，您可以在系統分析器 UI 中查看及分析系統設定檔。當您剖析系統並在 AGI 中開啟追蹤檔後，系統分析器會在時間軸中顯示剖析資料，列出可展開的項目來顯示其他詳細資料。

系統分析器 UI 的主要元素包括：

  • 工具列

    • 導覽模式按鈕

    • 追蹤篩選器文字方塊：篩選顯示在「track」窗格中的曲目。

    • 資訊按鈕 (i)：顯示追蹤記錄和裝置中繼資料。

    • 說明按鈕 (?)：顯示鍵盤和滑鼠快速鍵。

  • 時間軸：表示追蹤事件的時間範圍。

  • 「Track」窗格：顯示與時間軸相關的剖析資料。

  • 「Details」(詳細資料) 窗格：可展開的窗格，顯示所選項目的詳細資料。

剖析資料

在追蹤檔案中，剖析資料會儲存在具有時間戳記的事件 (稱為追蹤事件) 中。追蹤事件由各種類型的配量和計數器組成。舉例來說，CPU 追蹤事件包含排程配量，GPU 追蹤事件則包括 GPU 效能計數器和執行緒配量。

在系統分析器 UI 中，追蹤窗格包含追蹤事件，這些追蹤事件會顯示在已呼叫的測試群組中，並按照時間軸顯示。同類型的曲目會顯示在測試群組群組中。

GPU 軌跡

GPU 追蹤會顯示 GPU 剖析資訊。以下是主要的 GPU 測試群組類型：

  1. GPU 佇列軌跡：應用程式的 GPU 活動。

  2. GPU 計數器軌跡：GPU 的硬體計數器，會以固定時間間隔取樣。

  3. Vulkan 事件追蹤：Vulkan API 相關事件。

  4. SurfaceFlinger 軌跡：SurfaceFlinger 事件，指出圖形緩衝區在系統中的移動方式。

GPU 佇列軌跡

根據追蹤記錄期間執行的硬體佇列數量，GPU 可以有一或多個 GPU 佇列軌跡。GPU 佇列軌跡包含活動片段，代表應用程式使用 GPU 工作的時間和類型。

活動片段包含可查看的中繼資料，例如啟動工作的 Vulkan 指令緩衝區、轉譯傳遞和影格緩衝區。而 Vulkan 處理這些物件的操作會顯示在詳細資料窗格中，如下所示：

  • VkCommandBuffer
  • VkRenderPass
  • VkFrameBuffer

您可以使用 VK_EXT_debug_utils 擴充功能的 vkSetDebugUtilsObjectNameEXT 函式或 VK_EXT_debug_marker 擴充功能的 vkDebugMarkerSetObjectNameEXT 函式，為這些物件提供容易辨識的名稱，以便在追蹤記錄中一併識別這些項目。這兩個擴充功能都是由 AGI 實作，且可在追蹤時提供給您的應用程式。

GPU 計數器軌跡

GPU 計數器追蹤圖表，表示每隔一段時間取樣的 GPU 效能計數器值。這些圖表顯示不同樣本之間 GPU 基礎硬體元件的效能變化。您可以運用這項資訊，找出 GPU 用量的瓶頸。

可用的計數器是硬體專屬，將滑鼠遊標懸停在測試群組名稱上，即可查看每個計數器的簡短說明。詳情請參閱 GPU 效能計數器。

Vulkan 事件追蹤

Vulkan 事件測試群組會顯示追蹤期間記錄的 Vulkan API 事件。追蹤事件類型主要是佇列提交事件 (vkQueueSubmit 呼叫)。如果您按一下佇列提交事件，AGI 會醒目顯示與呼叫相關聯的 GPU 活動配量。您可以使用這項資料檢查由 Vulkan API 呼叫排入佇列的非同步工作，以及 CPU 和 GPU 之間的延遲時間。

SurfaceFlinger 軌跡

SurfaceFlinger 會追蹤顯示圖形緩衝區 (應用程式的交換鏈轉譯目標) 的生命週期，以免這些緩衝區在系統中爭用顯示，直到顯示為止。這些事件會依緩衝區匯總，方便您追蹤獲取和發布緩衝區所需的負擔和延遲時間。

與剖析資料互動

本節說明如何在系統分析器 UI 中與剖析資料互動。

釘選

你可以使用圖釘按鈕固定曲目及追蹤群組，

收合及展開

部分測試群組和所有測試群組群組可以收合。部分測試群組群組會在收合時顯示摘要。舉例來說，當收合時，CPU 追蹤群組會在圖表中顯示整體 CPU 使用率。

Zoom

AGI 會根據縮放等級匯總剖析資料。首次開啟追蹤檔時，系統分析器 UI 會以最大縮放比例顯示整個設定檔。如要檢查資料，您可以找出感興趣的區域，然後查看詳細資料。

當您放大及縮小不同的測試群組類型時，這些檢視畫面會顯示不同類型的剖析資料。舉例來說，CPU 會追蹤每個執行緒的初始顯示時間片段，然後在放大時改為顯示 CPU 核心使用率資料。

查看詳細資料

您可以在追蹤窗格中選取項目，在詳細資料窗格中顯示詳細中繼資料。如果項目可供選取，只要將滑鼠遊標懸停在該項目上，遊標就會變成指標，接著您就能選擇該項目。

選取時間範圍

您可以選取時間範圍，比較不同測試群組的追蹤事件。方法是啟用「時間」模式，然後拖曳以選取範圍。超出範圍的所有內容都會變暗，且會顯示該範圍的持續時間。

您也可以按下 M，選取所選配量的時間範圍。接著，您可以捲動其他測試群組，找出同一時間範圍內的事件。

您可使用 WASD 鍵或捲動及平移，在軌道窗格中瀏覽項目。系統分析器使用的鍵盤和滑鼠快速鍵與 Systrace 相同。可用的快速鍵包括：

  • W 和 S，或 Ctrl++ 和 Ctrl+- 即可縮放。
  • A、D 或 left 和 right 箭頭可左右平移檢視畫面。
  • Q、E 或 up 和 down 箭頭可捲動軌道。
  • 按住 shift 可增加導航的移動速度。
  • Ctrl+ 捲動可縮放所選項目。
  • F 會縮放所選項目。
  • 重設 Z+0，並完全縮小。
  • V 會醒目顯示 VSync (如果追蹤記錄中有該 VSync)。
  • M 會選取時間範圍來標示目前所選項目。
  • H 或 ? 會顯示鍵盤和滑鼠快速鍵一覽表。

工具列中包含可切換瀏覽模式的按鈕，用於選取您在軌跡窗格中拖曳項目時所執行的動作。您也可以按下 1、2、3 和 4 鍵選取下列導覽模式：

  1. 選取項目：拖曳即可選取項目。
  2. 平移：拖曳即可平移及捲動軌道。(此為預設模式)。
  3. 縮放：垂直拖曳即可縮放項目。
  4. 時間：拖曳即可選取時間範圍。

你也可以搭配下列輔助鍵使用瀏覽模式：

  • Shift+拖曳即可選取項目方塊。
  • Space+拖曳即可平移及捲動。
  • Ctrl+捲動即可縮放。
  • Ctrl+拖曳即可選取時間範圍。