設定效能問題快訊

如果程式碼變更或網路要求導致應用程式效能降低,請使用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 與 SlackJiraPagerDuty 的內建整合功能。

接收快訊

接收預設快訊

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

如要透過這個預設機制接收 Performance Monitoring 快訊,您必須具備 firebaseperformance.config.update 權限。下列角色預設包含這項必要權限:

快訊及其設定適用於整個專案。也就是說,根據預設,只要觸發效能快訊,所有專案成員都會收到電子郵件。系統只會將快訊傳送給具備快訊接收權限的專案成員,以及個別電子郵件地址 (不會傳送給 Google 群組或 Google Workspace 帳戶等帳戶群組)。

為帳戶開啟/關閉快訊

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

如要開啟或關閉Performance Monitoring快訊,請按照下列步驟操作:

  1. 前往 Firebase 控制台右上角的「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 天內收到資料的資源 ID 建立快訊。Performance Monitoring
  • 系統最近為自訂網址模式建立快訊。建立自訂網址模式並設定快訊後,您有 90 天的時間可傳送該模式的資料。如果 90 天內未傳送任何資料,Performance Monitoring就會移除該快訊。如要進一步瞭解自訂網址模式,請參閱「依顧客網址模式匯總資料」。

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

設定快訊

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

如果尚未將最新版 Performance Monitoring SDK 新增至應用程式,請立即新增。詳情請參閱 網頁AndroidAppleFlutter 平台的入門指南。

在每個已註冊的應用程式中,使用「追蹤記錄」表格或「資訊主頁報表資訊卡」,為要監控的每個指標設定快訊。每個應用程式可以有不同的快訊組合,且每個快訊的閾值可能不同 (或完全沒有快訊)。

在「追蹤記錄」表格中設定快訊

  1. 前往 Firebase 控制台的「資訊主頁」Performance Monitoring分頁標籤,然後選取要設定快訊的應用程式。

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

  3. 選取要設定快訊的追蹤類型分頁,然後找出適用的資料列。

  4. 在資料列最右側開啟溢位選單 (),然後選取「快訊設定」

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

在資訊主頁報表資訊卡中設定快訊

  1. 前往 Firebase 控制台的「資訊主頁」Performance Monitoring分頁標籤,然後選取要設定快訊的應用程式。

  2. 在「報表資訊卡」分頁中,找出要設定快訊的指標資訊卡。

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

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

設定成效快訊的最佳做法

網路要求

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

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

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

為自訂網址模式設定快訊

建議您為已設定的任何自訂網址模式設定快訊。由於 Firebase 會先嘗試將要求與自訂網址模式比對,因此類似的要求會更一致地對應至相同網址模式。這樣一來,團隊就能更有效率地接收自訂網址模式的快訊,因為您已將該特定模式的請求視為應用程式的重要項目。

設定自動網址模式的快訊

為自動網址模式設定快訊時,請確保自動網址模式已穩定運作幾天。請注意,自動網址模式可能會隨時間變更,且系統不會將快訊設定套用至新的網址模式。這可能會導致系統未正確或未發出您關注的模式警報。您也可以考慮建立自訂網址模式,確保模式穩定。

網頁載入

如要瞭解評估網站指標的建議門檻,請參閱網站體驗核心指標文件。

螢幕顯示

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