設定效能問題快訊

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

您可以設定並自訂應用程式的快訊，讓系統在發生以下情況時通知您： 某個事件的成效超過指定門檻

哪些因素會觸發快訊？

如果應用程式指標超過您允許的門檻，就會觸發快訊 定義。Firebase 只有在應用程式使用 即時相容的 SDK 版本。

應用程式啟動時間

只要設定應用程式啟動時間的快訊， 符合以下條件：

• Firebase 至少已記錄到「_app_start」的 100 個樣本 過去 1 小時內您應用程式的最新版本追蹤記錄。
• 在過去一小時內，_app_start 追蹤記錄的時間長度超過應用程式定義的門檻，且超過設定的百分比。
• 最近一次的快訊先前未針對相同門檻提高 新的應用程式版本

，瞭解如何調查及移除這項存取權。

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

自訂程式碼追蹤記錄

當您設定自訂程式碼追蹤指標的快訊時， 會觸發這個事件：

• Firebase 至少記錄了 100 個範例的自訂程式碼追蹤記錄 在過去一小時內安裝最新版本的應用程式。
• 追蹤記錄期間超過應用程式定義的閾值 最後一個小時和設定的百分位數
• (僅適用於 iOS+ 和 Android) 系統先前不會針對 指標的門檻。
• (僅適用於網頁) 先前未針對相同門檻發出任何快訊 (網頁在過去 3 天內)。

網路要求

當您設定網路要求指標的快訊時，會觸發快訊 符合下列所有條件時：

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

畫面轉譯

當您為畫面轉譯指標設定快訊時，快訊會 會觸發這個事件：

• Firebase 至少記錄了 100 個樣本樣本 過去 1 小時內針對您最新版應用程式的算繪。
• 指標的總和值在過去一小時內超過定義的閾值：
  • 凍結頁框：匯總值超過設定的門檻
  • 緩慢影格：匯總值超過設定的門檻
• 最近一次的快訊先前未針對相同門檻提高 新的應用程式版本

載入網頁

為網頁載入指標設定快訊時，如果 符合下列所有條件：

• 在載入網頁中，Firebase 記錄了至少 100 個樣本 最近 1 小時內發現您的應用程式
• 指標的匯總值在過去一天內超過了定義的門檻 針對設定的百分位數：
  • 首次輸入延遲：匯總值超過設定的閾值和設定的百分比
  • first contentful Paint：匯總值超過設定值 門檻和設定的百分位數
  • first Paint：匯總值超過設定門檻 和已設定的百分位數
• 過去未針對相同門檻發出快訊 3 天：

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

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

接收快訊

取得預設快訊

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

如要透過這個預設機制接收 Performance Monitoring 快訊，您必須具備 firebaseperformance.config.update 權限。以下角色包括 要求的權限：

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

快訊及其設定適用於整個專案。這表示系統根據預設 專案成員 (非電子郵件群組且具備接收快訊的必要權限) 會在成效快訊觸發時收到電子郵件。

為帳戶開啟/關閉快訊

你可以選擇在不必的情況下為自己的帳戶開啟/關閉 Performance Monitoring 快訊 影響到其他專案成員請注意，您仍需具備 接收快訊的權限

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

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

為第三方服務設定進階快訊功能

你也可以傳送 Performance Monitoring 快訊，至團隊偏好的通知 頻道 (使用 Cloud Functions for Firebase)。例如，您可以用 這個函式會擷取應用程式啟動時間緩慢的快訊事件，然後將 快訊資訊給第三方服務，例如 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」收到資料的資源 ID 建立快訊 最近 90 天內的活動記錄
• 這則快訊是最近為自訂網址模式建立的。建立 Deployment 後 自訂網址模式並設定快訊，您必須在 90 天內傳送以下資料： 如果在 90 天內沒有傳送任何資料，Performance Monitoring 就會移除該快訊。如要進一步瞭解自訂網址模式，請參閱「匯總客戶網址模式下的資料」。

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

設定快訊

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

將最新的 Performance Monitoring SDK 加入 (如果您尚未這麼做) 詳情請參閱網頁的入門指南。 Android、 Apple 和 Flutter 平台。

重要事項： 快訊及其設定會在專案層級套用，也就是說， 任何變更都會影響所有專案成員的快訊設定 Performance Monitoring快訊。

在每個已註冊的應用程式中，使用追蹤記錄表或資訊主頁報表資訊卡，為您要監控的每個指標設定快訊。每個應用程式都可以提供 有一組不同的快訊，且每個快訊的門檻都不同 (或是未在 全部)。

在「Traces」表格中設定快訊

1. 前往 Performance Monitoring 資訊主頁 分頁 前往 Firebase 控制台，選取要使用哪個應用程式的應用程式 設定快訊

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

3. 選取要設定快訊的追蹤類型分頁並 找出適用的列

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

4. 在該列最右側，開啟溢位選單 ()，然後選取 快訊設定：

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

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

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

1. 前往 Performance Monitoring 資訊主頁 分頁 前往 Firebase 控制台，選取要使用哪個應用程式的應用程式 設定快訊

2. 在「報表」資訊卡分頁中，找到您要查看的指標資訊卡 設定快訊

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

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

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

設定成效警示的最佳做法

網路要求

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

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

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

設定自訂網址模式的快訊

建議您為現有的自訂網址模式建立快訊 專案。因為 Firebase 會嘗試將要求與自訂網址模式進行比對 第一，類似的要求會更一致地對應至相同的網址模式。 如此一來，自訂網址模式的快訊就會更有效、更有效 因為您已識別出 視為應用程式的重要指標

設定自動網址模式快訊

為自動網址模式設定快訊時，請確定 網址模式已穩定幾天。請注意，自動建立網址 模式可能會隨時間改變，且快訊設定不會沿用至新的 網址模式。這可能會導致系統產生錯誤或缺少特定模式的快訊 自己在乎的事情您也可以考慮建立自訂的網址模式，藉此確保 保持穩定

載入網頁

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

畫面顯示

為確保最佳的應用程式體驗，使用者工作階段不應出現緩慢和凍結的畫面。Performance Monitoring 建議你為凍結影格設定快訊 且您設定了緩慢影格超過 5% 的快訊。個人中心 會發現這些值成為 效能快訊設定進一步瞭解緩慢語速過多 或凍結影格和其他應用程式效能最佳做法 Google Play 指南。