設定效能問題快訊

如果程式碼變更或網路要求降低應用程式效能，請使用 Performance Monitoring 快訊通知專案成員。

您可以為應用程式設定及自訂快訊，在事件成效超過設定的門檻時收到通知。

什麼情況會觸發警示？

如果應用程式指標超過您在 Firebase 控制台為指定百分位數 (如適用) 定義的門檻，系統就會觸發快訊。只有在應用程式使用與即時功能相容的 SDK 版本時，系統才會觸發快訊。

應用程式啟動時間

設定應用程式開始時間快訊後，如果符合下列所有條件，就會觸發快訊：

  • 在過去一小時內，Firebase 針對最新版本應用程式，記錄了至少 100 個_app_start 追蹤記錄樣本。
  • 在過去一小時內，_app_start 追蹤記錄的時間長度超過應用程式定義的門檻，且達到設定的百分位數。
  • 在最新版應用程式中，先前未曾針對相同門檻發出快訊。

自訂程式碼追蹤記錄

為自訂程式碼追蹤指標設定快訊後，如果符合下列所有條件，就會觸發快訊：

  • 在過去一小時內，Firebase 記錄了至少 100 個自訂程式碼追蹤記錄樣本，這些樣本來自最新版本的應用程式。
  • 在過去一小時內，追蹤記錄的時間長度超過應用程式定義的門檻，且超過設定的百分位數。
  • (僅限 iOS+ 和 Android) 先前未針對應用程式最新版本中的相同門檻發出快訊。
  • (僅限網頁) 過去 3 天內，未曾針對相同門檻發出快訊。

網路要求

為網路要求指標設定快訊時，如果符合下列所有條件，就會觸發快訊：

  • 在過去一小時內，Firebase 記錄了至少 100 個樣本，這些樣本與應用程式所有版本中的網址模式相符。
  • 指標的匯總值在過去一小時內超過定義的門檻：
    • 回應時間：匯總值超過所設百分位數的門檻
    • 成功率：(僅限 iOS+/Android) 所有使用者的匯總值低於設定的門檻
  • 過去 3 天內，未曾針對相同門檻發出快訊。

畫面轉譯

為畫面算繪指標設定快訊後，如果符合下列所有條件，就會觸發快訊：

  • Firebase 在過去一小時內，為最新版本應用程式記錄了至少 100 個畫面算繪樣本。
  • 指標的匯總值在過去一小時內超過定義的門檻：
    • 凍結影格：匯總值超過設定的門檻
    • 緩慢影格：匯總值超過設定的門檻
  • 在最新版應用程式中，先前未曾針對相同門檻發出快訊。

載入網頁

為網頁載入指標設定快訊後，如果符合下列所有條件，就會觸發快訊：

  • Firebase 在過去一小時內，至少記錄了 100 個應用程式載入網頁樣本。
  • 在過去一小時內，指標的匯總值超過定義的門檻，且達到設定的百分位數：
    • 首次輸入延遲時間：匯總值超過設定的門檻和百分位數
    • first contentful paint：匯總值超過設定的門檻和百分位數
    • first paint：匯總值超過設定的門檻和百分位數
  • 過去 3 天內，未曾針對相同門檻發出快訊。

進一步瞭解如何設定快訊、預設百分位數，以及為特定類型的追蹤記錄和指標設定快訊的最佳做法。

Performance Monitoring 快訊不適用於其他成效指標，或透過 Firebase 控制台設定的 Slack、Jira 或 PagerDuty 整合。

接收快訊

接收預設快訊

根據預設，Firebase 可透過電子郵件傳送Performance Monitoring快訊。

如要透過這項預設機制接收 Performance Monitoring 警告，您必須具備 firebaseperformance.config.update 權限。下列角色預設包含這項必要權限：

快訊和相關設定會套用至整項專案。這表示根據預設，觸發效能警訊時，每位專案成員都會收到電子郵件。快訊只會傳送給具備必要權限的專案成員，以及個別電子郵件地址 (而非 Google 群組或 Google Workspace 帳戶等帳戶群組)。

為帳戶開啟/關閉快訊

您可以為自己的帳戶啟用/停用 Performance Monitoring 快訊，不會影響其他專案成員。請注意，您仍須具備必要權限才能接收警告。

如要開啟或關閉Performance Monitoring警示，請按照下列步驟操作：

  1. 前往 Firebase 控制台右上角的「 Firebase alerts」(Firebase 快訊)。
  2. 接著前往「 設定」，選擇帳戶的 Performance Monitoring 快訊偏好設定。

設定第三方服務的進階快訊

您也可以使用 Cloud Functions for Firebase，將 Performance Monitoring 警告傳送至團隊偏好的通知管道。舉例來說，您可以編寫函式，擷取應用程式啟動時間過慢的快訊事件，並將快訊資訊發布至第三方服務，例如 Discord、Slack 或 Jira。

如要使用 Cloud Functions for Firebase 設定進階警告功能，請按照下列步驟操作：

  1. 設定 Cloud Functions for Firebase，包括下列工作：

    1. 設定 Node.js 或 Python 的開發環境。
    2. 安裝並登入 Firebase CLI。
    3. 使用 Firebase CLI 初始化 Cloud Functions for Firebase。

  2. 編寫及部署函式，擷取 Performance Monitoring 的快訊事件，並處理事件酬載 (例如在 Discord 訊息中張貼快訊資訊)。

如要瞭解可擷取的所有效能警示事件，請參閱效能監控警示的參考文件。

自動移除無效快訊

Performance Monitoring 會驗證快訊，確保資料有效且快訊正在使用中。只要符合下列任一條件，快訊就會視為有效：

  • 系統會為過去 90 天內 Performance Monitoring 收到資料的資源 ID 建立快訊。
  • 最近為自訂網址模式建立的快訊。建立自訂網址模式並設定快訊後，您有 90 天的時間可以傳送該模式的資料。如果 90 天內未傳送任何資料，Performance Monitoring 就會移除該警告。如要進一步瞭解自訂網址模式，請參閱「依客戶網址模式匯總資料」。

如果未符合上述任一條件，Performance Monitoring 就會移除快訊。

設定警告

如要設定 Performance Monitoring 警告，您必須具備 firebaseperformance.config.update 權限。下列角色預設包含這項必要權限：Firebase 效能管理員、Firebase 品質管理員、Firebase 管理員，以及專案擁有者或編輯者。

如果尚未新增，請將最新的 Performance Monitoring SDK 新增至應用程式。詳情請參閱 Web、Android、Apple 和 Flutter 平台的入門指南。

在每個已註冊的應用程式中，使用「Traces」(追蹤記錄) 表格或「Dashboard」(資訊主頁) 報表資訊卡，為要監控的每項指標設定快訊。每個應用程式都可以有一組不同的快訊，每組快訊都有不同的門檻 (或完全沒有快訊)。

在「Traces」(追蹤記錄) 表格中設定警告

  1. 在 Firebase 控制台中，前往Performance Monitoring「Dashboard」(資訊主頁) 分頁，然後選取要設定警告的應用程式。

  2. 向下捲動至畫面底部的「追蹤記錄」表格。

  3. 選取要設定警告的追蹤記錄類型分頁，然後找出適用的資料列。

  4. 開啟該列最右側的溢位選單 ()，然後選取「Alert settings」(快訊設定)。

  5. 按照畫面上的指示，設定應用程式的警告門檻和百分位數 (如適用)，或開啟/關閉警告。Android 和 iOS 的預設百分位數為第 90 位，網頁則為第 75 位。如要進一步瞭解預設百分位數，請參閱「在資訊主頁中追蹤重要指標」。

在資訊主頁報表資訊卡中設定警告

  1. 在 Firebase 控制台中，前往Performance Monitoring「Dashboard」(資訊主頁) 分頁，然後選取要設定警告的應用程式。

  2. 在「Report card」(報表資訊卡) 分頁中，找出要設定快訊的指標資訊卡。

  3. 在所需指標資訊卡中，開啟溢位選單 ()，然後選取「Alert settings」(快訊設定)。

  4. 按照畫面上的指示，設定應用程式的警告門檻和百分位數 (如適用)，或開啟/關閉警告。Android 和 iOS 的預設百分位數為第 90 位，網頁則為第 75 位。如要進一步瞭解預設百分位數，請參閱「在資訊主頁中追蹤重要指標」。

設定效能警訊的最佳做法

網路要求

Firebase 會根據網址模式匯總類似網路要求的資料，網址模式可以是下列任一項：

  • 使用者定義的模式，稱為「自訂網址模式」。

  • Firebase 衍生的模式，稱為自動網址模式。
    這些模式可能會隨著應用程式的最新使用行為而改變。

設定自訂網址模式的快訊

建議您為設定的所有自訂網址模式設定快訊。由於 Firebase 會先嘗試將要求與自訂網址模式進行比對，因此類似的要求會更一致地對應至相同的網址模式。由於您已將特定要求模式視為對應用程式至關重要，因此自訂網址模式的快訊對團隊來說更有意義，也更有效。

設定自動網址模式快訊

為自動網址模式設定快訊時，請確保自動網址模式已穩定運作幾天。請注意，自動網址模式可能會隨時間變更，且快訊設定不會沿用至新的網址模式。這可能會導致您關注的模式出現錯誤或遺漏快訊。您也可以考慮建立自訂網址模式，確保模式穩定。

載入網頁

如要瞭解評估網頁指標的建議門檻，請參閱 Core Web Vitals 說明文件。

畫面轉譯

為確保最佳應用程式體驗，使用者工作階段不應出現緩慢和凍結影格。Performance Monitoring 建議您設定凍結畫面超過 1% 的快訊，以及緩慢畫面超過 5% 的快訊。在設定效能警訊時，您會發現這些值是預設設定。如要進一步瞭解過多緩慢或凍結影格，以及其他應用程式效能最佳做法，請參閱 Google Play 指南。