如果程式碼變更或網路要求導致應用程式效能降低,請使用Performance Monitoring快訊通知專案成員。
您可以為應用程式設定及自訂快訊,在事件成效超過設定的門檻時收到通知。
系統會在什麼情況下發出警示?
當應用程式的指標超過您在 Firebase 控制台中為指定百分位數定義的門檻 (如適用),系統就會觸發快訊。只有在應用程式使用支援即時效能資料的 SDK 版本時,才會觸發快訊。
應用程式啟動時間
設定應用程式啟動時間的快訊時,如果符合下列所有條件,系統就會觸發快訊:
- 過去 1 小時內,Firebase 記錄到應用程式最新版本至少
100 個樣本 的_app_start
追蹤記錄。 - 在過去一小時內,
_app_start
追蹤記錄的持續時間超過應用程式定義的門檻,且達到設定的百分位數。 - 在最新版應用程式中,相同門檻先前並未引發警示。
自訂程式碼追蹤記錄
設定自訂程式碼追蹤指標的快訊時,如果符合下列所有條件,系統就會觸發快訊:
- Firebase 在過去一小時內,記錄了應用程式最新版本中自訂程式碼追蹤記錄的
至少 100 個樣本 。 - 在過去一小時內,追蹤記錄的持續時間超過應用程式定義的門檻,且達到設定的百分位數。
- (僅限 iOS+ 和 Android) 最新版應用程式中,相同門檻先前未引發任何警示。
- (僅限網站) 過去
3 天 內,系統未針對相同門檻發出快訊。
網路要求
設定網路要求指標的快訊時,如果符合下列所有條件,系統就會觸發快訊:
- Firebase 在過去一小時內,記錄到至少
100 個樣本 符合您應用程式所有版本的網址模式。 - 過去一小時內,指標的匯總值超過定義的門檻:
- 回應時間:匯總值超過設定的百分位數門檻
- 成功率:(僅限 iOS+/Android) 所有使用者的匯總值低於設定的門檻
- 過去
3 天 內,相同門檻未曾觸發快訊。
畫面顯示
設定畫面算繪指標的快訊時,如果符合下列所有條件,系統就會觸發快訊:
- 在過去一小時內,Firebase 記錄了最新應用程式版本至少
100 個樣本 的畫面算繪情形。 - 在過去一小時內,指標的匯總值超過定義的門檻:
- 凍結影格:匯總值超過設定的門檻
- 緩慢影格:匯總值超過設定的門檻
- 在最新版應用程式中,相同門檻先前並未引發警示。
載入網頁
為網頁載入指標設定快訊時,如果符合下列所有條件,系統就會觸發快訊:
- Firebase 在過去 1 小時內,記錄到應用程式的網頁載入情形至少
100 個樣本 。 - 在過去一小時內,指標的匯總值已超過定義的門檻,且達到設定的百分位數:
- 首次輸入延遲:匯總值超過設定的門檻和設定的百分位數
- 首次顯示內容:匯總值超過設定的門檻和設定的百分位數
- 首次顯示:匯總值超過設定的門檻和設定的百分位數
- 過去
3 天 內,相同門檻未曾觸發快訊。
進一步瞭解如何設定快訊、預設百分位數,以及針對特定類型的追蹤記錄和指標設定快訊的最佳做法。
Performance Monitoring 快訊不適用於其他效能指標的快訊,也不適用於 Firebase 與 Slack、Jira 和 PagerDuty 的內建整合功能。
接收快訊
接收預設快訊
根據預設,Firebase 會透過電子郵件傳送 Performance Monitoring 快訊。
如要透過這個預設機制接收 Performance Monitoring 快訊,您必須具備 firebaseperformance.config.update
權限。下列角色預設包含這項必要權限:
快訊及其設定適用於整個專案。也就是說,根據預設,只要觸發效能快訊,所有專案成員都會收到電子郵件。系統只會將快訊傳送給具備快訊接收權限的專案成員,以及個別電子郵件地址 (不會傳送給 Google 群組或 Google Workspace 帳戶等帳戶群組)。
為帳戶開啟/關閉快訊
你可以為自己的帳戶開啟/關閉Performance Monitoring快訊,不會影響其他專案成員。請注意,您仍須具備必要權限才能接收快訊。
如要開啟或關閉Performance Monitoring快訊,請按照下列步驟操作:
- 前往 Firebase 控制台右上角的「Firebase 快訊」
。 - 接著前往「設定」
,選擇帳戶的快訊偏好設定 Performance Monitoring。
設定第三方服務的進階快訊
您也可以使用 Cloud Functions for Firebase,將 Performance Monitoring 快訊傳送至團隊偏好的通知管道。舉例來說,您可以編寫函式,擷取應用程式啟動時間過慢的快訊事件,並將快訊資訊發布至 Discord、Slack 或 Jira 等第三方服務。
如要使用 Cloud Functions for Firebase 設定進階快訊功能,請按照下列步驟操作:
設定 Cloud Functions for Firebase,包括下列工作:
- 設定 Node.js 或 Python 的開發環境。
- 安裝並登入 Firebase CLI。
- 使用 Firebase CLI 初始化 Cloud Functions for Firebase。
編寫及部署函式,從 Performance Monitoring 擷取快訊事件,並處理事件酬載 (例如在 Discord 訊息中發布快訊資訊)。
如要瞭解可擷取的所有效能快訊事件,請參閱效能監控快訊的參考說明文件。
自動移除無效快訊
Performance Monitoring 會驗證快訊,確保資料有效且快訊處於使用中狀態。如果符合下列任一條件,系統就會將快訊視為有效:
- 系統會為過去 90 天內收到資料的資源 ID 建立快訊。Performance Monitoring
- 系統最近為自訂網址模式建立快訊。建立自訂網址模式並設定快訊後,您有 90 天的時間可傳送該模式的資料。如果 90 天內未傳送任何資料,Performance Monitoring就會移除該快訊。如要進一步瞭解自訂網址模式,請參閱「依顧客網址模式匯總資料」。
如果不符合上述任一條件,Performance Monitoring 就會移除快訊。
設定快訊
如要設定 Performance Monitoring 警告,您必須具備 firebaseperformance.config.update
權限。下列角色預設包含這項必要權限:Firebase 效能管理員、Firebase 品質管理員、Firebase 管理員,以及專案擁有者或編輯者。
如果尚未將最新版 Performance Monitoring SDK 新增至應用程式,請立即新增。詳情請參閱 網頁、Android、Apple 和 Flutter 平台的入門指南。
在每個已註冊的應用程式中,使用「追蹤記錄」表格或「資訊主頁報表資訊卡」,為要監控的每個指標設定快訊。每個應用程式可以有不同的快訊組合,且每個快訊的閾值可能不同 (或完全沒有快訊)。
在「追蹤記錄」表格中設定快訊
前往 Firebase 控制台的「資訊主頁」Performance Monitoring分頁標籤,然後選取要設定快訊的應用程式。
向下捲動至畫面底部的「追蹤」表格。
選取要設定快訊的追蹤類型分頁,然後找出適用的資料列。
在資料列最右側開啟溢位選單 (
),然後選取「快訊設定」。按照畫面上的指示,設定應用程式的快訊門檻和百分位數 (如適用),或開啟/關閉快訊。Android 和 iOS 應用程式的預設百分位數為第 90 位,網頁應用程式則為第 75 位。如要進一步瞭解預設百分位數,請參閱「在資訊主頁中追蹤重要指標」。
在資訊主頁報表資訊卡中設定快訊
前往 Firebase 控制台的「資訊主頁」Performance Monitoring分頁標籤,然後選取要設定快訊的應用程式。
在「報表資訊卡」分頁中,找出要設定快訊的指標資訊卡。
在所需指標資訊卡中開啟溢位選單 (
),然後選取「快訊設定」。按照畫面上的指示,設定應用程式的快訊門檻和百分位數 (如適用),或開啟/關閉快訊。Android 和 iOS 應用程式的預設百分位數為第 90 位,網頁應用程式則為第 75 位。如要進一步瞭解預設百分位數,請參閱「在資訊主頁中追蹤重要指標」。
設定成效快訊的最佳做法
網路要求
Firebase 會根據網址模式匯總類似網路要求的資料,網址模式可以是下列任一項:
使用者定義的模式,稱為「自訂網址模式」。
為自訂網址模式設定快訊
建議您為已設定的任何自訂網址模式設定快訊。由於 Firebase 會先嘗試將要求與自訂網址模式比對,因此類似的要求會更一致地對應至相同網址模式。這樣一來,團隊就能更有效率地接收自訂網址模式的快訊,因為您已將該特定模式的請求視為應用程式的重要項目。
設定自動網址模式的快訊
為自動網址模式設定快訊時,請確保自動網址模式已穩定運作幾天。請注意,自動網址模式可能會隨時間變更,且系統不會將快訊設定套用至新的網址模式。這可能會導致系統未正確或未發出您關注的模式警報。您也可以考慮建立自訂網址模式,確保模式穩定。
網頁載入
如要瞭解評估網站指標的建議門檻,請參閱網站體驗核心指標文件。
螢幕顯示
為確保提供最佳應用程式體驗,使用者工作階段應避免出現緩慢和凍結的影格。Performance Monitoring 建議您設定凍結影格超過 1% 的快訊,以及慢速影格超過 5% 的快訊。您會發現,這些值在設定效能快訊時,會以預設設定的形式呈現。如要進一步瞭解過多緩慢或凍結的影格,以及其他應用程式效能最佳做法,請參閱 Google Play 指南。