Performance Monitoring 疑難排解與常見問題

管理中心表示已偵測到 SDK，但沒有顯示任何資料

Performance Monitoring 會先處理成效事件資料，再將資料顯示在成效資訊主頁中。

如果「SDK 偵測到」訊息出現後超過 24 小時，但您仍未看到資料，請檢查 Firebase 狀態資訊主頁，看看是否有已知的服務中斷情形。如果沒有停機情形，請與 Firebase 支援團隊聯絡。

應用程式未記錄效能事件

如果您沒有看到效能事件的記錄訊息，請嘗試下列疑難排解步驟：

1. 請確認 Performance Monitoring SDK 未透過 Info.plist 檔案中的下列任一標記停用：

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. 請確認 Performance Monitoring 在執行階段不會停用 (Swift | Obj-C)。

3. 如果您找不到應用程式中已停用的項目，請與 Firebase 支援團隊聯絡。

效能資訊主頁缺少畫面追蹤記錄資料

如果您沒有畫面轉譯追蹤記錄的資料，請嘗試下列疑難排解步驟：

1. 請確認您使用的是最新版的 Apple 平台 SDK (11.5.0 以上版本)。螢幕轉譯追蹤記錄僅適用於 v5.0.0 以上版本。

2. Performance Monitoring 不會為容器檢視控制器 (例如 UINavigationController 和 UITabBarController) 建立螢幕轉譯追蹤記錄。如果只有這些畫面缺少資料，則這是預期的行為。

成效資訊主頁缺少自訂追蹤資料

您是否只看到自動收集的追蹤記錄資料，而沒有自訂程式碼追蹤記錄資料？請嘗試下列疑難排解步驟：

1. 檢查透過 Trace API 檢測自訂程式碼追蹤記錄的設定，特別是下列項目：

   • 自訂程式碼追蹤記錄和自訂指標的名稱必須符合下列規定：開頭或結尾不得有空白字元、開頭不得有底線 (_) 字元，且長度上限為 32 個字元。
   • 所有追蹤記錄都必須啟動及停止。未啟動、未停止或在啟動前停止的追蹤記錄將不會記錄。

2. 查看記錄訊息，確認 Performance Monitoring 是否記錄預期的自訂程式碼追蹤記錄。

3. 如果 Performance Monitoring 正在記錄事件，但 24 小時後沒有顯示任何資料，請與 Firebase 支援團隊聯絡。

效能資訊主頁缺少網路要求資料

如果網路要求資料遺失，請嘗試下列疑難排解步驟：

1. 檢查網路程式庫是否相容。Performance Monitoring 會自動收集網路要求的指標，這些網路要求使用下列網路程式庫：

   • Swift：URLSession 和 URLConnection
   • Objective-C：NSURLSession 和 NSURLConnection

   請注意，您可以為網路要求新增自訂監控。

2. 請留意下列事項：

   • 視程式碼的行為和程式碼使用的網路程式庫而定，Performance Monitoring 可能只會回報已完成的網路要求。也就是說，系統可能不會回報已開啟的 HTTP/S 連線。

   • Performance Monitoring 不會回報含有無效 Content-Type 標頭的網路要求。不過，系統仍會接受沒有 Content-Type 標頭的網路要求。

網路要求資料無法依預期進行匯總

進一步瞭解Performance Monitoring 如何在網址模式下匯總網路要求資料。

你也可以試試自訂網址模式！

專案首頁「成效」資訊卡中的「主要問題」有什麼變化？

我們將「重要問題」替換為「近期快訊」，這是因為我們最近推出了快訊功能，當您設定的門檻值遭到觸及時，系統會自動通知您。問題已淘汰，並由警示取代。

成效資訊卡頂端的應用程式選取器會篩選「最近的警示」下方的警示項目。系統只會顯示所選應用程式的三則最新快訊。

如要進一步瞭解警示，請參閱「設定效能問題警示」。

在控制台中設定問題門檻的功能發生了什麼問題？

Performance Monitoring 支援超過定義門檻的指標快訊。為避免與這些可設定的效能指標閾值混淆，我們已移除設定問題閾值的功能。

Firebase 控制台中的「詳細資料」和「指標」資訊發生了什麼事？

我們已將「詳細資料」和「指標」頁面替換為全新設計的集中式使用者介面 (UI)，藉此改善排解問題的方式。這個新的疑難排解 UI 提供與「詳細資料」和「指標」相同的核心功能。如要進一步瞭解如何排解問題，請參閱「查看特定追蹤記錄的更多資料」。

為什麼樣本數與預期不符？

Performance Monitoring 會從應用程式使用者的裝置收集效能資料。如果應用程式有許多使用者，或是應用程式產生大量效能活動，Performance Monitoring 可能會將資料收集作業限制在部分裝置上，以減少所處理事件的數量。這些上限值相當高，即使事件數量較少，指標值仍可代表使用者的應用程式體驗。

為管理收集的資料量，Performance Monitoring 會使用下列取樣選項：

• 裝置內的速率限制：為避免裝置突然大量傳送追蹤記錄，我們將裝置傳送的程式碼和網路要求追蹤記錄數量限制為每 10 分鐘 300 個事件。這種做法可防止裝置受到迴圈檢測工具的影響，因為迴圈檢測工具會傳送大量效能資料，並防止單一裝置扭曲效能測量結果。

• 動態取樣：Performance Monitoring 每天會從所有應用程式使用者收集有限數量的程式碼追蹤記錄和網路要求追蹤記錄。系統會在裝置上擷取動態取樣率 (使用 Firebase Remote Config)，以判斷隨機裝置是否應擷取及傳送追蹤記錄。未選取用於取樣的裝置不會傳送任何事件。動態取樣率是應用程式專屬的，會調整以確保收集的資料總量維持在限制以下。

  啟用 BigQuery 整合功能的專案，可獲得較高的網路要求追蹤記錄數上限。

  使用者工作階段會從使用者的裝置傳送額外的詳細資料，因此需要更多資源才能擷取及傳送資料。為盡量減少使用者工作階段的影響，Performance Monitoring 也可能會限制工作階段數量。

• 伺服器端速率限制：為確保應用程式不會超出取樣限制，Performance Monitoring 可能會使用伺服器端取樣功能，捨棄從裝置收到的部分事件。雖然這類限制不會影響指標的有效性，但可能會造成模式出現輕微變化，包括：

  • 追蹤記錄的數量可能與程式碼執行次數不同。
  • 在程式碼中緊密連結的追蹤記錄，每個追蹤記錄的樣本數量可能不同。

主控台的「Issues」分頁發生什麼問題？

我們已將「問題」分頁替換為「警示」，當您設定的閾值超出時，系統會自動通知您。您不再需要手動查看 Firebase 控制台，即可判斷門檻狀態。如要瞭解快訊，請參閱「設定效能問題快訊」。

控制台中的「裝置」和「網路」分頁發生什麼問題？如何查看這些頁面上的追蹤記錄？

我們已重新設計 Firebase 主控台的 Performance Monitoring 部分，讓「資訊主頁」分頁可在單一空間顯示重要指標和所有追蹤記錄。在重新設計的過程中，我們移除了「裝置」和「網路」頁面。

「Dashboard」分頁底部的追蹤記錄表格會顯示「On device」和「Network」分頁顯示的所有資訊，但會加入一些額外功能，包括依特定指標的百分比變更排序追蹤記錄。如要查看特定追蹤記錄的所有指標和資料，請按一下追蹤記錄表中的追蹤記錄名稱。

您可以在追蹤記錄表的下列子分頁中查看追蹤記錄：

• 網路要求追蹤記錄 (內建和自訂) - 網路要求 子分頁
• 自訂程式碼追蹤記錄 -「自訂追蹤記錄」子分頁
• 應用程式啟動、應用程式前景、應用程式背景追蹤記錄 - 自訂追蹤記錄子分頁
• 畫面轉譯追蹤記錄 -「畫面轉譯」子分頁
• 網頁載入追蹤記錄 - 網頁載入 子分頁

如要進一步瞭解追蹤記錄表、查看指標和資料，請前往控制台總覽頁面 (iOS+ | Android | 網頁)。

為什麼緩慢影格和凍結影格的數量不如預期？

系統會假設裝置的刷新率為 60 Hz，並據此計算出顯示速度緩慢的畫面和凍結畫面。如果裝置的刷新率低於 60 Hz，每秒轉譯的影格數量較少，因此每個影格的轉譯時間會變慢。轉譯時間越長，系統回報的緩慢影格或凍結影格就越多，因為轉譯的畫面越多，就越容易出現緩慢或凍結的畫面。不過，如果裝置的螢幕更新率高於 60Hz，則每個影格都會縮短算繪時間。這可能會導致系統回報的緩慢影格或凍結影格數量減少。這是 Performance Monitoring SDK 目前的限制。

匯出至 BigQuery 的 Performance Monitoring 資料比預期時間長。不是即時資訊嗎？

如果您已為 Firebase Performance Monitoring 啟用 BigQuery 整合功能，資料會在當天結束後 12 到 24 小時內匯出至 BigQuery (太平洋時間)。

舉例來說，4 月 19 日的資料會在 4 月 20 日下午 12 點至午夜之間，於 BigQuery 中顯示 (所有日期和時間均為太平洋時間)。

「近乎即時」效能資料是什麼意思？

Firebase Performance Monitoring 會在收集到成效資料時立即處理，因此 Firebase 主控台會顯示近乎即時的資料。處理完成的資料會在收集後的幾分鐘內顯示在主控台中，因此稱為「近乎即時」。

如要充分利用近乎即時的資料處理功能，請確認應用程式使用與即時處理相容的 SDK 版本。

如何取得應用程式的近乎即時效能資料？

如要充分利用近乎即時的資料處理功能，您只需要確保應用程式使用的 Performance Monitoring SDK 版本與即時資料處理功能相容即可。

以下是支援即時效能資料的 SDK 版本：

• iOS：7.3.0 以上版本
• tvOS：8.9.0 以上版本
• Android：19.0.10 以上版本 (或 Firebase Android BoM 26.1.0 以上版本)
• 網頁：7.14.0 以上版本

請注意，我們一律建議您使用最新版的 SDK，但上述任何版本都能讓 Performance Monitoring 以近乎即時的方式處理您的資料。

哪些版本的 Performance Monitoring SDK 屬於即時相容版本？

以下是支援即時資料處理的 SDK 版本：

• iOS：7.3.0 以上版本
• tvOS：8.9.0 以上版本
• Android：19.0.10 以上版本 (或 Firebase Android BoM 26.1.0 以上版本)
• 網頁：7.14.0 以上版本

請注意，我們一律建議您使用最新版的 SDK，但上述任何版本都能讓 Performance Monitoring 以近乎即時的方式處理您的資料。

如果我未更新應用程式，以便使用與即時 SDK 相容的版本，該怎麼辦？

如果應用程式未使用與即時 SDK 相容的版本，您仍可在 Firebase 控制台中查看所有應用程式效能資料。不過，成效資料的顯示時間會比收集時間晚約 36 小時。

我已更新至支援即時效能資料的 SDK 版本，但部分使用者仍使用舊版應用程式。我是否仍會在 Firebase 控制台中看到他們的效能資料？

當然可以！無論應用程式執行個體使用哪個 SDK 版本，您都會看到所有使用者的效能資料。

不過，如果您查看近期資料 (約 36 小時內的資料)，系統會顯示使用即時相容 SDK 版本的應用程式執行個案使用者的資料。不過，非近期資料包含所有應用程式版本的成效資料。