開始使用 Flutter 適用的 Performance Monitoring

本快速入門導覽課程說明如何設定 Firebase Performance Monitoring，協助您深入瞭解 Flutter 應用程式的效能特性。

事前準備

如果您尚未設定及初始化 Firebase，請先在 Flutter 專案中完成這些步驟。

步驟 1：在應用程式中新增 Performance Monitoring

1. 在 Flutter 專案的根目錄中，執行下列指令來安裝 Performance Monitoring Flutter 外掛程式：

   flutter pub add firebase_performance
   

2. 在 Flutter 專案的根目錄中，執行下列指令：

   flutterfire configure
   

   執行這項指令，可確保 Flutter 應用程式的 Firebase 設定為最新狀態，並在 Android 應用程式中加入必要的 Performance Monitoring Gradle 外掛程式。

3. 完成後，請重新建構 Flutter 專案：

   flutter run
   

新增 Performance Monitoring SDK 後，Firebase 會自動開始收集與應用程式生命週期相關的資料 (例如應用程式啟動時間)，以及 HTTP/S 網路要求的資料。

在 Flutter 上，無法自動監控個別 Flutter 畫面的螢幕轉譯效能。單一檢視控制器會以原生方式封裝整個 Flutter 應用程式，因此基礎原生 Firebase SDK 不會偵測到畫面轉換。

注意：將 Performance Monitoring 新增至應用程式時，遠端設定 SDK 會做為依附元件一併加入。如果您已使用遠端設定，則不會看到任何差異。不過，如果您是第一次使用遠端設定，請參閱遠端設定說明文件，進一步瞭解可在應用程式中使用的各種功能。

步驟 2：產生效能事件，以便顯示初始資料

成功將 SDK 新增至應用程式後，Firebase 就會開始處理事件。如果您仍在本機開發，請與應用程式互動，產生事件，以便進行初始資料收集和處理。

注意：效能監控 SDK 會在本機批次處理事件，然後定期 (每 30 秒) 或在應用程式回到前景時，將事件傳送至 Firebase。因此，在應用程式互動發生後，Firebase 需要一段時間才會收到應用程式傳送的事件資訊。

1. 使用模擬器或測試裝置繼續開發應用程式。

2. 在背景和前景之間切換應用程式數次、在不同畫面之間瀏覽，以及/或觸發網路要求，藉此與應用程式互動並產生事件。

3. 前往 Firebase 控制台的效能資訊主頁。幾分鐘內，您應該會看到初始資料顯示。

   如果沒有看到初始資料，請參閱疑難排解提示。

步驟 3：(選用) 查看效能事件的記錄訊息

1. 查看記錄訊息，瞭解是否有任何錯誤訊息。

   Performance Monitoring 會使用下列標記來標記記錄訊息，方便您篩選記錄訊息：

   • iOS+：Firebase/Performance
   • Android：FirebasePerformance

2. 請檢查下列類型的記錄，確認 Performance Monitoring 是否正在記錄效能事件：

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

3. 按一下網址，即可在 Firebase 控制台中查看資料。資訊主頁中的資料可能需要幾分鐘才會更新。

步驟 4：(選用) 為特定程式碼新增自訂監控功能

如要監控與應用程式中特定程式碼相關聯的成效資料，您可以檢測自訂程式碼追蹤記錄。

透過自訂程式碼追蹤記錄，您可以評估應用程式完成特定工作或一組工作所需的時間，例如載入一組圖片或查詢資料庫。自訂程式碼追蹤記錄的預設指標是時間長度，但您也可以新增自訂指標，例如快取命中和記憶體警告。

在程式碼中，您可以使用 Performance Monitoring SDK 提供的 API，定義自訂程式碼追蹤記錄的開頭和結尾 (並新增任何所需的自訂指標)。

請參閱「新增特定程式碼的監控功能」，進一步瞭解這些功能，以及如何將這些功能新增至應用程式。

步驟 5：部署應用程式並查看結果

使用模擬器和一或多部測試裝置驗證 Performance Monitoring 後，即可向使用者部署更新版應用程式。

您可以在 Firebase 控制台的「Performance」(效能) 資訊主頁中監控成效資料。

後續步驟

• 進一步瞭解 Performance Monitoring 自動收集的資料：

  • 與應用程式生命週期相關的資料，例如應用程式啟動時間
  • 應用程式發出的 HTTP/S 網路要求資料

• 在 Firebase 控制台中查看、追蹤及篩選成效資料。

• 檢測自訂程式碼追蹤記錄，為應用程式中的特定工作或工作流程新增監控功能。

• 使用屬性篩選成效資料。