瞭解 HTTP/S 網路要求效能資料 (任何應用程式)


Performance Monitoring 會使用追蹤記錄,收集應用程式中受監控程序的資料。追蹤記錄是一份報表,內含應用程式中兩個時間點之間擷取的資料。

無論應用程式類型為何,Performance Monitoring 都會自動收集應用程式發出的每個網路要求追蹤記錄,稱為 HTTP/S 網路要求追蹤記錄。這些追蹤記錄會收集指標,記錄應用程式向服務端點發出要求,到該端點完成回應之間的時間。對於應用程式發出要求的任何端點,Performance Monitoring 會擷取多項指標:

  • 回應時間:從提出要求到完整收到回應的時間

  • 回應酬載大小:應用程式下載的網路酬載位元組大小

您可以在「效能資訊主頁」Performance底部的追蹤記錄資料表中,透過「網路要求」Network requests子標籤查看這些追蹤記錄的資料 (請參閱本頁後續內容,進一步瞭解如何使用控制台)。

現成的監控功能涵蓋應用程式的大部分網路要求。不過,如果 Firebase 透過衍生的自動網址模式比對功能,無法擷取特定網址,您可以建立自訂網址模式,監控特定網址組合。

網址模式下的資料匯總

Firebase Performance Monitoring 會自動匯總類似網路要求的資料,協助您瞭解網路要求效能的趨勢。

Firebase 會檢查每個網路要求的網址是否符合網址模式。如果要求網址符合網址模式,Firebase 會自動將要求的資料匯總到網址模式下。Firebase 會在 Firebase 控制台 「Performance」資訊主頁的「Network」分頁中,顯示網址 模式和匯總資料。

什麼是網址模式?

網址模式包含網域和可與網址路徑比對的模式,例如:example.com/*/animals/**。

  • 網址模式可包含下列路徑片段:

    • 純文字:比對完全一致的字串
    • *:比對單一路徑區隔中的任何字串
    • **:比對任意路徑後置字串
  • 網址模式可以是:

舉例來說,下列任何網址要求都可能與網址模式 example.com/*/animals/** 相符。

  • example.com/singapore/animals
  • example.com/australia/animals/spiders
  • example.com/australia/animals/marsupials/koala.png

網址模式的網域也可以包含 * 做為第一個區段,例如:*.example.com/*/fruits/**。

Firebase 會將每項要求對應至單一網址模式。如果您已設定任何自訂網址模式,Firebase 會先嘗試將要求網址與這些模式進行比對。如果 Firebase 找不到相符的自訂網址模式,就會將要求網址與最具代表性的自動網址模式進行比對。如要進一步瞭解自動和自訂網址模式,請參閱下列各節。

自動網址模式

即使您未進行任何設定,Performance Monitoring 也會嘗試將應用程式的要求與自動網址模式進行比對,反映應用程式的最新使用行為。

自動網址模式比對的運作方式為何?

Firebase 會根據應用程式傳送的要求,衍生出最具代表性的自動網址模式,並將每個要求與該模式進行比對。不過請注意,Firebase 會先嘗試將要求網址與任何已設定的自訂網址模式進行比對。

以下是基本範例,說明 Firebase 如何嘗試將要求與應用程式最具代表性的自動網址模式進行比對。

  1. 應用程式會向類似下列的網址傳送多項要求:

    • example.com/germany/animals/bears
    • example.com/germany/animals/birds
    • example.com/germany/cars

    Firebase 判定 example.com/germany/** 是應用程式的常見要求模式,並將其新增為專案中的自動網址模式。

    對於與這個網址模式相符的任何「新」比對成功的請求,Firebase 會將要求的資料匯總到自動網址模式 example.com/germany/** 下。

  2. 一週後,應用程式的大部分要求都會傳送至 example.com/germany/animals/bears 和 example.com/germany/animals/birds。因此,Firebase 會衍生出更具代表性的網址模式 example.com/germany/animals/**。

    對於符合這個新網址模式的任何「新」比對成功的請求,Firebase「只會」匯總新網址模式下的要求資料。Firebase 會繼續匯總 example.com/germany/** 下 example.com/germany/cars 要求的資料。

  3. 不過,在接下來幾週內,應用程式對 example.com/germany/animals/bears 和 example.com/germany/animals/birds 的要求會大幅減少。Firebase 判定 example.com/germany/animals/** 無法代表應用程式最新的使用行為,因此開始將這兩項要求重新比對至 example.com/germany/**。

    Firebase 不會再彙整 example.com/germany/animals/** 下的任何要求資料,因為這不再是最具代表性的自動網址模式。

由於自動網址模式比對是動態的,請注意下列事項:

  • 先前要求的比對結果和匯總資料不受新網址模式影響。Firebase 不會追溯重新匯總要求資料。

  • 只有日後的要求會受到新網址模式影響。Firebase 會將每個新要求對應至最具代表性的自動網址模式。不過請注意,Firebase 會先嘗試將要求網址與任何已設定的自訂網址模式進行比對。

查看自動網址模式及其資料

Firebase 會在追蹤記錄表格的 「Network requests」(網路要求) 子分頁中,顯示所有網址模式及其匯總資料。該表格位於 Firebase 控制台 「Performance」(效能) 資訊主頁底部。

您可能會看到標示為「未分類」的網址模式。這些是「廣泛」的自動網址模式,Firebase 可在這些模式下,匯總不符合任何更具體網址模式的要求資料。

當網址模式下匯總資料的資料保留期限結束時,Firebase 會從網址模式中刪除該資料。如果自動網址模式下匯總的所有資料都已過期,Firebase 會從 Firebase 控制台刪除該網址模式。

自訂網址模式

您可以建立自訂網址模式,監控 Firebase 透過衍生的自動網址模式比對功能無法擷取的特定網址模式。舉例來說,您可以使用自訂網址模式,排解特定網址的問題,或長期監控一組特定網址。

詳情請參閱「建立自訂網址模式」。

追蹤、查看及篩選成效資料

如要查看即時成效資料,請確認應用程式使用的 Performance Monitoring SDK 版本與即時資料處理功能相容。進一步瞭解即時成效資料。

在資訊主頁中追蹤特定指標

如要瞭解主要指標的趨勢,請將這些指標新增至「成效」資訊主頁頂端的指標面板。您可以查看每週變化,快速找出迴歸問題,或確認最近的程式碼變更是否能提升效能。

<span class=Firebase Performance Monitoring 資訊主頁」/>

如要在指標面板中新增指標,請按照下列步驟操作:

  1. 前往 Firebase 控制台的「Performance」(效能) 資訊主頁。
  2. 按一下空白指標資訊卡,然後選取要新增至面板的現有指標。
  3. 按一下已填入資料的指標資訊卡上的 ,即可查看更多選項,例如取代或移除指標。

指標面板會以圖表和數值百分比變化的形式,顯示一段時間內收集的指標資料。

進一步瞭解如何使用資訊主頁。

查看追蹤記錄和相關資料

如要查看追蹤記錄,請前往 Firebase 控制台的「Performance」(效能) 資訊主頁,向下捲動至追蹤記錄表格,然後按一下適當的子分頁。表格會顯示每個追蹤記錄的一些重要指標,您甚至可以依特定指標的百分比變化排序清單。

Performance Monitoring 在 Firebase 控制台中提供疑難排解頁面,醒目顯示指標變化,方便您快速解決效能問題,並盡可能降低對應用程式和使用者的影響。當您發現潛在的效能問題時,可以使用疑難排解頁面,例如在下列情況:

  • 您在資訊主頁上選取相關指標,發現有很大的差異。
  • 在追蹤記錄表中,您將資料排序,在頂端顯示最大差異,並看到顯著的百分比變化。
  • 您收到電子郵件快訊,通知您有效能問題。

您可以透過下列方式存取疑難排解頁面:

  • 在指標資訊主頁上,按一下「查看指標詳細資料」按鈕。
  • 在任一指標資訊卡上,依序選取「 => 查看詳細資料」。疑難排解頁面會顯示所選指標的相關資訊。
  • 在追蹤記錄表格中,按一下追蹤記錄名稱,或與該追蹤記錄相關聯的資料列中的任何指標值。
  • 在電子郵件快訊中,按一下「立即調查」。

在追蹤記錄表格中點選追蹤記錄名稱,即可深入查看感興趣的指標。按一下「Filter」(篩選) 按鈕,即可依屬性篩選資料,例如:

<span class=Firebase Performance Monitoring data being filtered by attribute" />
  • 依「網頁網址」篩選,查看網站特定網頁的資料
  • 依「有效連線類型」篩選,瞭解 3G 連線對應用程式的影響
  • 依「國家/地區」篩選,確保資料庫位置不會影響特定區域

進一步瞭解如何查看追蹤記錄資料。

後續步驟

  • 進一步瞭解如何使用屬性查看成效資料。

  • 進一步瞭解如何在 Firebase 控制台追蹤效能問題。

  • 設定快訊,在網路要求降低應用程式效能時通知您。舉例來說,您可以設定電子郵件快訊,在特定網址模式的回應時間超過設定的門檻時,通知團隊。