開始使用網頁版 Performance Monitoring

事前準備

如果您尚未將 Firebase 新增至 JavaScript 專案，請參閱「將 Firebase 新增至 JavaScript 專案」一文，瞭解如何：

  • 建立 Firebase 專案

  • 透過 Firebase 註冊網頁應用程式

請注意，將 Firebase 新增至應用程式時，您可能需要完成本頁後續所述的部分步驟 (例如新增 SDK 和初始化 Firebase)。

步驟 1：新增並初始化 Performance Monitoring

  1. 如果您尚未 安裝 Firebase JS SDK 並初始化 Firebase，請先完成這項操作。

  2. 新增 Performance Monitoring JS SDK 並初始化 Performance Monitoring：

Web 

import { initializeApp } from "firebase/app";
import { getPerformance } from "firebase/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = getPerformance(app);

Web 

import firebase from "firebase/compat/app";
import "firebase/compat/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = firebase.performance();

步驟 2：新增第一個輸入延遲 polyfill 程式庫

如要評估首次輸入延遲指標，您必須為此指標新增 polyfill 程式庫。如需安裝操作說明，請參閱程式庫的說明文件。

Performance Monitoring 不需要加入這個 polyfill 程式庫，即可回報其他網頁應用程式指標。

步驟 3：產生初始資料顯示的成效事件

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

  1. 在本機環境中提供及檢視網頁應用程式。

  2. 載入網站的子頁面、與應用程式互動，以及/或觸發網路要求，藉此產生事件。請務必在網頁載入後，將瀏覽器分頁保持開啟狀態至少 10 秒。

  3. 前往 Firebase 主控台的「效能」資訊主頁。您應該會在幾分鐘內看到初步資料。

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

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

  1. 開啟瀏覽器的開發人員工具 (例如 Chrome 開發人員工具的「Network」分頁，或 Firefox 的「Network Monitor」)。

  2. 在瀏覽器中重新整理網路應用程式。

  3. 檢查記錄訊息，看看是否有任何錯誤訊息。

  4. 幾秒後，請在瀏覽器的開發人員工具中尋找網路呼叫 firebaselogging.googleapis.com。如果有該網路呼叫，即表示瀏覽器正在傳送效能資料至 Firebase。

如果您的應用程式未記錄效能事件，請參閱疑難排解提示。

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

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

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

在程式碼中，您可以使用 Performance Monitoring SDK 提供的 API 定義自訂程式碼追蹤的起點和終點 (以及新增任何所需的自訂指標)。

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

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

驗證 Performance Monitoring 後，您就可以向使用者部署更新版應用程式。

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

後續步驟