Performance Monitoring 會收集追蹤記錄，協助您監控應用程式效能。A 罩杯 追蹤是系統擷取的
您可以自行建立追蹤記錄，監控與 的特定程式碼透過自訂程式碼追蹤記錄，您可以評估 應用程式完成特定工作或一組工作所需的時間 載入一組圖片或查詢資料庫的範例。
自訂程式碼追蹤記錄的預設指標為「時間長度」(從 追蹤記錄的起點和停止點)，但您可以新增 自訂指標。
在您的程式碼中，您可以使用 使用效能監控 SDK 提供的 API
建立自訂程式碼追蹤記錄後，隨時都能啟用， 如何確保執行緒安全
由於這些追蹤記錄的預設指標是「持續時間」，因此不會 有時也稱為「時間長度追蹤記錄」。
您可以在追蹤記錄的「自訂追蹤記錄」子分頁中查看這些追蹤記錄的資料 表格，位於「成效」資訊主頁底部 (進一步瞭解 使用主控台)。
預設屬性、自訂屬性和自訂指標
如果是自訂程式碼追蹤記錄，Performance Monitoring 會自動記錄 預設屬性 (應用程式版本、國家/地區、裝置等常見的中繼資料) ，以便在 Firebase 控制台中篩選追蹤記錄資料。個人中心 您也可以新增及監控自訂屬性 例如遊戲關卡或使用者屬性。
您可以進一步設定要記錄的自訂程式碼追蹤記錄 自訂指標：適用於符合以下條件的成效相關事件： 發生在此追蹤範圍內的情形舉例來說，您可以建立自訂指標 快取命中和失敗的次數，或 UI 產生 在明顯的時段內沒有回應。
自訂屬性和自訂指標會顯示在 Firebase 控制台中 追蹤記錄的預設屬性和預設指標。
新增自訂程式碼追蹤記錄
使用 Performance Monitoring Trace API 來新增自訂程式碼追蹤記錄，以監控特定的應用程式程式碼。
注意事項：
- 一個應用程式可以有多個自訂程式碼追蹤記錄。
- 您可以同時執行多個自訂程式碼追蹤記錄。
- 自訂程式碼追蹤的名稱必須符合下列規定：
開頭或結尾沒有空白、無前置底線 (
_) 字元， 長度上限為 100 個半形字元 - 自訂程式碼追蹤記錄支援新增自訂指標和 自訂屬性。
如要開始及停止自訂程式碼追蹤記錄，請包裝要用於追蹤的程式碼 類似下方的程式碼：
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
在自訂程式碼追蹤記錄中新增自訂指標
使用 Performance Monitoring Trace API 即可在自訂程式碼追蹤記錄中加入自訂指標。
注意事項：
- 自訂指標的名稱必須符合下列規定：
開頭或結尾沒有空白、無前置底線 (
_) 字元， 長度上限為 100 個半形字元 - 每個自訂程式碼追蹤記錄最多可記錄 32 個指標 (包括預設指標) Duration 指標)。
如要新增自訂指標，每次新增一行類似下方的程式碼 事件發生的時間舉例來說 應用程式內發生的效能相關事件，例如快取命中或 重試。
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
建立自訂程式碼追蹤記錄的自訂屬性
如要使用自訂屬性，請在應用程式中加入用來定義該屬性的程式碼 會將其與特定自訂程式碼追蹤記錄建立關聯。您可以設定 屬性。
注意事項：
自訂屬性名稱必須符合下列規定： 開頭或結尾沒有空白、無前置底線 (
_) 字元， 長度上限為 32 個半形字元每個自訂程式碼追蹤記錄最多可記錄 5 個自訂屬性。
請勿使用含有個人資訊的自訂屬性 用於識別個人身分。
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
追蹤、查看及篩選成效資料
在資訊主頁中追蹤特定指標
如要瞭解重要指標的變化趨勢，請將這些指標新增至指標資訊板： 「Performance」(效能) 資訊主頁頂端。如要快速找出迴歸問題 或確認程式碼最近的變更 改善成效
如要在指標板中新增指標，請前往「效能」資訊主頁 在 Firebase 控制台中，按一下「資訊主頁」分頁標籤。按一下空白指標 資訊卡，然後選取現有指標以加入主面板。按一下產業別 已填入的指標資訊卡上的刪節號 (⋮) 列出更多選項，例如 取代或移除指標
指標資訊板會以圖表形式顯示一段時間內收集到的指標資料 以及數值百分比的變化
進一步瞭解如何使用資訊主頁。
查看追蹤記錄和相關資料
如要查看追蹤記錄，請前往「效能」資訊主頁 在 Firebase 控制台中，向下捲動至追蹤記錄表格，然後按一下 適當的子分頁表格會顯示每筆追蹤記錄的熱門指標 甚至可以根據特定指標的變化百分比來排序清單。
如果在追蹤記錄表格中點選追蹤記錄名稱，就可以點選節流 透過不同畫面探索追蹤記錄，並深入查看感興趣的指標。 在多數頁面中，您可以使用「篩選器」按鈕 (畫面左上方) 執行以下動作： 依據屬性篩選資料，例如：
- 依應用程式版本篩選，即可查看過去或最新版本的資料 版本
- 依「裝置」篩選，瞭解舊版裝置如何處理您的應用程式
- 依「國家/地區」篩選，確保資料庫位置不會影響 特定區域
進一步瞭解如何查看追蹤記錄資料。
後續步驟
進一步瞭解 使用屬性來查看成效資料。
進一步瞭解如何 追蹤成效問題的 Firebase 控制台。
設定快訊，以因應成效下滑的程式碼變更 應用程式的效能舉例來說，您可以設定 修正特定自訂程式碼追蹤記錄的時間長度超過 門檻值