設定效能問題快訊

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

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

什麼會觸發警示？

當應用程式指標超過您在 Firebase 控制台中為特定百分比 (如適用) 定義的門檻時，系統就會觸發快訊。只有在應用程式使用支援即時效能資料的 SDK 版本時，系統才會觸發快訊。

應用程式啟動時間

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

• Firebase 在過去 1 小時內，為應用程式的最新版本記錄了至少 100 個 _app_start 追蹤記錄。
• 在過去一小時內，_app_start 追蹤記錄的時間長度超過應用程式定義的門檻，且超過設定的百分比。
• 在應用程式最新版本中，先前並未針對相同的門檻觸發警報。

注意： 根據預設，每個應用程式都會啟用應用程式啟動時間快訊，且預設門檻為 90 百分位數的 5 秒。

自訂程式碼追蹤記錄

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

• Firebase 在過去一小時內，為應用程式的最新版本記錄至少 100 個樣本的自訂程式追蹤記錄。
• 追蹤記錄的時間長度超過應用程式在過去一小時內定義的門檻，且超過設定的百分比。
• (僅限 iOS+ 和 Android) 在應用程式最新版本中，先前並未針對相同的門檻發出警示。
• (僅限網頁版) 過去 3 天內，系統並未針對相同的門檻發出警報。

網路要求

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

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

畫面轉譯

設定螢幕算繪指標的快訊時，如果符合下列所有條件，系統就會觸發快訊：

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

網頁載入

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

• Firebase 在過去 1 小時內記錄了應用程式至少 100 個樣本的網頁載入情形。
• 指標的匯總值在過去一小時內，以及在設定的百分比內，都超過定義的門檻：
  • 首次輸入延遲：匯總值超過設定的閾值和設定的百分比
  • 首次顯示內容所需時間：匯總值超過設定的閾值和設定的百分比
  • 首次顯示：匯總值超過設定的閾值和設定的百分比
• 過去3 天內，沒有針對相同門檻發出過任何快訊。

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

Performance Monitoring 快訊不適用於其他效能指標的快訊，或是 Slack、Jira 和 PagerDuty 內建 Firebase 整合的快訊。

接收快訊

接收預設快訊

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

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

• Firebase Performance 管理員
• Firebase 品質管理員
• Firebase 管理員
• 專案擁有者或編輯者

快訊和相關設定適用於整個專案。也就是說，根據預設，每當效能快訊觸發時，每位專案成員都會收到電子郵件。系統只會將快訊傳送給具備接收快訊所需權限的專案成員，以及個別電子郵件地址 (不會傳送給 Google 網路論壇或 Google Workspace 帳戶等帳戶群組)。

為帳戶開啟/關閉快訊

您可以為自己的帳戶開啟/關閉 Performance Monitoring 警示，而不影響其他專案成員。請注意，您仍需要必要的權限才能接收快訊。

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

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

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

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

注意： 如要使用進階快訊功能，您的 Firebase 專案必須採用 Blaze 定價方案。

如要使用 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 快訊的參考說明文件。

自動移除無效的快訊

Performance Monitoring 會驗證警示，確保資料有效且警示處於有效使用狀態。只要符合下列任一條件，系統就會發出有效的警報：

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

如果不符合上述任一條件，Performance Monitoring 就會移除警示。

設定快訊

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

如果您尚未這麼做，請將最新版 Performance Monitoring SDK 新增至應用程式。如需更多資訊，請參閱 網頁、Android、Apple 和 Flutter 平台的入門指南。

重要事項： 快訊及其設定適用於整個專案，也就是說，任何變更都會影響所有收到 Performance Monitoring 快訊的專案成員的快訊設定。

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

在「Traces」表格中設定快訊

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

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

3. 選取要設定快照警示的類型分頁，然後找出適用的資料列。

   注意： _app_start 追蹤記錄位於「自訂追蹤記錄」分頁中。

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

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

   注意： 百分位設定不適用於成功率、凍結影格或慢速影格，因為這些指標都是百分比。

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

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

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

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

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

   注意： 百分位設定不適用於成功率、凍結影格和慢速影格，因為這些指標都是百分比。

設定成效警示的最佳做法

網路要求

Firebase 會匯總網址模式下相似網路要求的資料，網址模式可為下列任一項：

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

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

設定自訂網址模式的快訊

建議您為所設定的任何自訂網址模式設定快訊。由於 Firebase 會先嘗試將要求比對至自訂網址模式，因此相似要求會更一致地對應至相同的網址模式。這樣一來，自訂網址模式的快訊對團隊來說就更有意義且更有效，因為您已將該特定要求模式視為應用程式的重要元素。

設定自動網址模式的快訊

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

網頁載入

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

螢幕轉譯

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