本頁提供開始使用 Performance Monitoring 和
使用 Performance Monitoring 的各項功能和工具。
初步檢查疑難排解
以下兩項是建議所有人採用的通用最佳做法
,再進行進一步疑難排解。
1. 查看效能事件的記錄訊息
查看記錄訊息,確認 Performance Monitoring SDK 會擷取
效能事件
如何查看效能事件的記錄訊息
啟用偵錯記錄功能,如下所示:
- 在 Xcode (最低 v15.2) 中,選取 Product >
配置 >編輯配置。
- 選取左選單中的「Run」(執行),然後選取「Arguments」分頁標籤。
- 在「Passed on Launch」區段中,新增
-FIRDebugEnabled
。
檢查記錄訊息,看看是否有任何錯誤訊息。
Performance Monitoring 會以 Firebase/Performance
標記記錄訊息,方便您
篩選記錄訊息
查看以下類型的記錄,找出 Performance Monitoring 為
記錄效能事件:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
按一下網址,即可在 Firebase 控制台查看資料。這項作業可能需要
資料更新。
如果您的應用程式未記錄效能事件,請參閱疑難排解
提示。
2. 查看 Firebase 狀態資訊主頁
查看
Firebase 狀態資訊主頁
已知的 Firebase 或 Performance Monitoring 發生服務中斷情形。
開始使用 Performance Monitoring
如要開始使用 Performance Monitoring
(iOS 以上版本 |
Android 版 |
網頁),下列疑難排解說明
這些提示可協助您處理 Firebase 偵測或顯示 SDK 的相關問題
您的第一項成效資料位於 Firebase 控制台。
已將 SDK 新增至應用程式,但 Play 管理中心
仍表示要新增 SDK
Firebase 可偵測您是否已成功將 Performance Monitoring SDK 加入應用程式
。
通常在啟動應用程式後的 10 分鐘內,效能
資訊主頁
Firebase 控制台顯示「偵測到 SDK」撰寫新的電子郵件訊息然後,在 30 天內
分鐘,資訊主頁會顯示初始處理的資料。
如果 10 分鐘過後,
但您的應用程式仍然沒有任何異動,請查看您的記錄
訊息,確保 Performance Monitoring 會記錄
事件。依照下列適當的疑難排解步驟操作,
排解 SDK 偵測延遲訊息的問題。
應用程式正在記錄事件:疑難排解
步驟
如果您在本機進行開發,請嘗試為資料產生更多事件
集合:
繼續使用模擬器或測試裝置開發應用程式。
將應用程式切換為背景或前景以產生事件
反覆切換不同畫面來與應用程式互動
及/或觸發網路要求
確認您的 Firebase 設定
檔案 (Google-Service-Info.plist
) 是
且並未修改檔案。
具體來說,請檢查下列事項:
如果應用程式中的設定檔似乎有誤,請嘗試下列做法:
刪除應用程式目前使用的設定檔。
請按照這些指示下載
建立新的設定檔並新增至 Apple 應用程式。
如果 SDK 正在記錄事件,且所有設定皆正確無誤,
但還是看不到 SDK 偵測訊息或已處理的資料
(2 小時後),請與 Firebase 支援團隊聯絡。
一般疑難排解
如果您已成功新增 SDK,並在應用程式中使用 Performance Monitoring,
下列疑難排解提示可解決一般
Performance Monitoring的功能和工具。
效能資訊主頁為
缺少螢幕追蹤記錄資料
如果缺少畫面轉譯追蹤記錄的資料,請嘗試下列做法
疑難排解步驟:
效能資訊主頁為
缺少自訂追蹤記錄資料
您是否看到自動收集的追蹤記錄成效資料,但
自訂程式碼追蹤記錄?請嘗試下列疑難排解步驟:
檢查透過
Trace API,
尤其是以下:
- 自訂程式碼追蹤和自訂指標的名稱必須符合下列規定
要求:開頭或結尾不含空白字元,沒有前置底線
(
_
) 的字元,長度上限為 32 個半形字元。
- 您必須開始及停止所有追蹤記錄。任何未啟動 (而非) 的追蹤記錄
停止或停止前停止。
查看記錄訊息,確定
Performance Monitoring會記錄預期的自訂程式碼追蹤記錄。
如果 Performance Monitoring 會記錄事件,但 24 小時後仍未顯示資料,
請與 Firebase 支援團隊聯絡。
效能資訊主頁
沒有網路要求資料
如果你找不到網路要求資料,請嘗試以下疑難排解步驟:
檢查網路程式庫不相容。已自動Performance Monitoring
收集網路要求的指標
使用下列網路程式庫:
- Swift:URLSession 和 URLConnection
- Objective-C:NSURLSession 和 NSURLConnection
請注意,您可以為網路新增自訂監控功能。
要求。
請留意下列事項:
常見問題
Project 首頁的成效資訊卡「主要問題」怎麼了?
我們已將重要問題替換為近期快訊,做為後續追蹤之用
最近推出了幾項快訊功能,這項功能會在
您設定的閾值會跨越您設定的門檻問題已淘汰
並由快訊取代
「成效」資訊卡頂端的應用程式選取器會篩選快訊
「近期快訊」下的項目。針對
系統隨即會顯示所選應用程式。
如要進一步瞭解快訊,請參閱
設定效能問題快訊。
在控制台中設定問題閾值的能力如何?
Performance Monitoring 支援快訊指標超過
定義的閾值為了避免與以下項目的可自行設定閾值混淆:
我們移除了設定閾值的功能
問題。
Firebase 控制台中的詳細資料和指標資訊怎麼了?
我們重新設計了「詳細資料」和「指標」頁面,全新重新設計的集中化介面
使用者介面 (UI),提升排解問題的方式。這項新功能
疑難排解 UI 所提供的核心功能與「詳細資料」和
提供指標。如要進一步瞭解疑難排解,請參閱:
查看特定追蹤記錄的其他資料。
為什麼樣本數量與預期不符?
Performance Monitoring 會從應用程式的使用者裝置收集效能資料。如果您的
或應用程式產生大量效能
活動,Performance Monitoring 可能會將資料收集範圍限制在部分裝置
減少已處理的事件數這些限制夠高
即使事件較少,指標值仍代表
使用者體驗
為管理我們收集的資料量,Performance Monitoring 會使用以下資料:
取樣選項:
裝置端頻率限制:如何避免裝置突然傳送大量
追蹤,我們會限制從用戶端伺服器傳送的程式碼與網路要求追蹤數量
每 10 分鐘最多播放 300 個事件這個做法可以保護裝置
迴圈檢測作業可能會傳送大量效能資料
這可以防止單一裝置在測量效能時出現偏差。
動態取樣:Performance Monitoring 收集的限制約為 1 億筆
每個應用程式每日的程式碼追蹤記錄事件和 1 億個網路要求追蹤記錄的事件
適用於所有應用程式使用者系統會在裝置上擷取動態取樣率 (使用
Firebase Remote Config) 用於判斷隨機裝置是否應
擷取及傳送追蹤記錄。未選擇抽樣的裝置不會進行
會傳送任何事件。動態取樣率僅適用於應用程式,並調整為
確保收集的資料總量不超過限制。
使用者工作階段會從使用者的裝置傳送其他詳細資料,因此需要
更多資源來擷取與傳送資料為了將
工作階段數量,Performance Monitoring 可能也會限制工作階段數量。
伺服器端頻率限制:確保應用程式不會超出取樣量
限制,Performance Monitoring 可能會使用伺服器端取樣功能捨棄部分事件
收到的訊息。雖然這種限制不會改變
這可能會導致數據模式改變,包括
包括:
- 追蹤記錄數量可能會與單一區塊
相關程式碼
- 在程式碼中緊密耦合的追蹤記錄,可能會各自有不同數量的追蹤記錄
樣本。
,瞭解如何調查及移除這項存取權。
控制台的「問題」分頁怎麼了?
推出「快訊」功能,取代了「問題」分頁
會在超過設定的門檻時自動通知您。你不行
就不再需要手動檢查 Firebase 控制台來判斷
例如閾值如要瞭解快訊功能,請參閱「設定效能問題快訊」一文。
控制台的「裝置上」和「網路」分頁有什麼影響?
如何查看這些網頁中的追蹤記錄?
我們重新設計了 Firebase 控制台的 Performance Monitoring 部分,
「Dashboard」(資訊主頁) 分頁會在單一空間顯示重要指標和所有追蹤記錄。阿斯
我們在重新設計時一併移除了「裝置上」和「網路」頁面。
「資訊主頁」分頁底部的追蹤記錄表,都相同
「裝置上」和「網路」分頁顯示的資訊,但有一些
例如可以按照百分比排序追蹤記錄
特定指標的變化如何查看特定所有的指標和資料
追蹤記錄,請按一下追蹤記錄表格中的追蹤記錄名稱。
在追蹤記錄表的下列子分頁中查看追蹤記錄:
- 網路要求追蹤記錄 (現成和自訂) -「聯播網請求」子分頁
- 自訂程式碼追蹤:「自訂追蹤」子分頁
- 應用程式啟動、應用程式前景、應用程式在背景中的追蹤記錄 - 「自訂追蹤記錄」子分頁
- 畫面轉譯追蹤記錄 -「螢幕轉譯」子分頁
- 網頁載入追蹤:「網頁載入」子分頁
如要進一步瞭解追蹤記錄表格並查看指標和資料,請前往
主控台總覽頁面
(iOS 以上版本 |
Android |
網頁)。
為什麼緩慢影格和凍結影格的數量與預期不符?
轉譯速度緩慢的影格和凍結影格,都是以假設的裝置計算
刷新率為 60Hz。如果裝置刷新率低於 60 Hz,則每個影格
會使轉譯時間較慢,因為每秒轉譯的影格數較少。
如果轉譯時間較慢,系統可能會回報緩慢影格或凍結影格的數量
因為轉譯速度變慢或畫面凍結但如果裝置
刷新率高於 60 Hz,每個影格的轉譯時間都會更快。
這可能會導致回報的緩慢影格或凍結影格數量較少。這是
Performance Monitoring SDK 的限制。
匯出至以下目標的「Performance Monitoring」資料所需時間超出預期
BigQuery。並非即時資料嗎?
如果已為「Firebase Performance Monitoring」啟用 BigQuery 整合功能,您的資料
會在當天結束 (太平洋時間) 後的 12 至 24 小時內匯出至 BigQuery
時間)。
舉例來說,系統會在 4 月 20 日在 BigQuery 中提供 4 月 19 日的資料
中午 12 點到午夜 (所有日期和時間皆為太平洋時間)。
近乎即時的資料處理和顯示
「近乎即時」是什麼?成效資料代表的意義為何?
Firebase Performance Monitoring 會在處理期間收集成效資料,
結果將以近乎即時的方式顯示在 Firebase 控制台。已處理
資料收集作業會在幾分鐘內顯示在控制台中,
提供「近乎即時」的字詞。
如要使用近乎即時的資料處理功能,請確認您的應用程式使用
即時相容的 SDK
版本。
如何取得近乎即時的應用程式效能資料?
如要以近乎即時的方式處理資料,您只需要確保
應用程式使用與即時相容的 Performance Monitoring SDK 版本
資料處理。
以下是即時相容的 SDK 版本:
- iOS - 7.3.0 以上版本
- tvOS - 8.9.0 以上版本
- Android - v19.0.10 以上版本 (或 Firebase Android BoM v26.1.0 以上版本)
- 網頁版 - 7.14.0 以上版本
請注意,我們建議您一律使用最新版 SDK,但
上述版本會讓「Performance Monitoring」以近乎真實的方式處理您的資料
讓應用程式從可以最快做出回應的位置
回應使用者要求
哪些 Performance Monitoring SDK 版本可視為即時相容?
下列為與即時資料處理相容的 SDK 版本:
- iOS - 7.3.0 以上版本
- tvOS - 8.9.0 以上版本
- Android - v19.0.10 以上版本 (或 Firebase Android BoM v26.1.0 以上版本)
- 網頁版 - 7.14.0 以上版本
請注意,我們建議您一律使用最新版 SDK,但
上述版本會讓「Performance Monitoring」以近乎真實的方式處理您的資料
讓應用程式從可以最快做出回應的位置
回應使用者要求
如果我不將應用程式更新為使用即時相容的 SDK 版本,會發生什麼情況?
如果您的應用程式未使用即時相容的 SDK 版本,您仍會看到
Firebase 控制台提供應用程式的所有效能資料。不過,螢幕
從資料擷取當下算起,成效資料大概會延遲 36 小時
集合。
我已更新至與即時相容的 SDK 版本,但有些使用者
仍持續使用舊版應用程式我會繼續查看成效嗎?
「Firebase」控制台中的資料嗎?
當然可以!無論應用程式執行個體使用哪個 SDK 版本,您會看見
以及所有使用者的成效資料
不過,如果您查看的是近期資料 (不到 36 小時)
則顯示的資料來自應用程式執行個體的使用者
相容的 SDK 版本。沒有近期的資料則會包含成效資料
。
如果發生以下情況:
與 Firebase 支援團隊聯絡。
請務必附上 Firebase 應用程式 ID。在以下頁面找出您的 Firebase 應用程式 ID:
「您的應用程式」資訊卡
settings 專案
設定。