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


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

對於所有應用程式類型，Performance Monitoring 會自動為應用程式發出的每個網路要求收集追蹤記錄，稱為 HTTP/S 網路要求追蹤記錄。這些追蹤記錄會收集應用程式向服務端點發出要求，以及該端點回應完成之間的時間長度。對於應用程式提出要求的任何端點，Performance Monitoring 會擷取多個指標：

  • 回應時間：從提出要求到完全收到回應的時間

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

  • 要求酬載大小：應用程式上傳的網路酬載位元組大小

  • 成功率：成功回應 (回應代碼介於 100 到 399 之間) 與回應總數的百分比

您可以在追蹤記錄表的「網路要求」子分頁中查看這些追蹤記錄的資料，該子分頁位於「效能」資訊主頁的底部 (請參閱本頁後續的使用主控台相關說明)。

Performance Monitoring 會自動收集使用下列網路庫的網路要求指標：

Swift

  • URLSession
  • URLConnection

Objective-C

  • NSURLSession
  • NSURLConnection

自訂網路要求資料匯總

除了網路要求的即用工具和資料匯總功能外，Performance Monitoring 也支援下列選項：

  • 手動檢測網路要求追蹤記錄：即時監控功能包含應用程式的大部分網路要求。不過，系統可能不會回報某些要求，或者您可能會使用其他程式庫來提出網路要求。在這種情況下，您可以使用 Performance Monitoring API 手動檢測自訂網路要求追蹤記錄。
  • 匯總自訂網址模式下的資料：如果 Firebase 無法透過衍生自動網址模式比對功能擷取特定網址，您可以建立自訂網址模式，隨時監控特定網址組。
  • 自訂計算成功率的方式：有時，某些 API 端點會產生錯誤代碼，或是已在應用程式中處理。在這種情況下，您可以設定計算成功率的方式，並更準確地監控應用程式網路呼叫的成功率。

依據網址模式匯總資料

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

Firebase 會針對每個要求檢查網路要求的網址是否符合網址模式。如果要求網址符合網址模式，Firebase 會自動在網址模式下匯總要求資料。Firebase 會在 Firebase 主控台的「成效」資訊主頁的「網路」分頁中，顯示網址模式及其匯總資料。

什麼是網址模式？

網址模式包含網域和可與網址路徑相符的模式，例如：example.com/*/animals/**。

  • 網址模式可包含下列路徑部分：

    • 純文字：與字串完全相符
    • *：比對單一路徑片段中的任何字串
    • **：比對任意路徑後置字串

  • 網址模式可以是下列任一內容：

    • Firebase 衍生模式 (稱為「自動網址模式」)
    • 使用者定義的模式 (稱為「自訂網址模式」)

舉例來說，下列任一網址要求都可能符合網址模式 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/cars 下 example.com/germany/** 的資料要求。

  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 主控台的「效能」資訊主頁。
  2. 按一下空白的指標資訊卡，然後選取要新增至看板的現有指標。
  3. 在已填入資料的指標資訊卡上按一下 ，即可查看更多選項，例如取代或移除指標。

指標資訊主頁會顯示收集到的指標資料，包括圖表形式和數字百分比變化。

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

查看追蹤記錄及其資料

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

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

  • 您選取資訊主頁上的相關指標，並發現差異很大。
  • 在追蹤記錄表中，您可以排序來顯示最大差異，並查看百分比變化幅度。
  • 您會收到電子郵件快訊，通知您有效能問題。

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

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

在追蹤記錄表中按一下追蹤記錄名稱，即可深入瞭解感興趣的指標。按一下「Filter」 按鈕，即可依屬性篩選資料，例如：

<span class=Firebase Performance Monitoring 資料以「/>」屬性篩選
  • 依「應用程式版本」篩選，查看過去或最新版本的資料
  • 依「裝置」篩選，瞭解舊版裝置如何處理您的應用程式
  • 依「國家/地區」篩選，確認資料庫位置不會影響特定區域

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

後續步驟

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

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

  • 設定快訊，針對降低應用程式效能的網路要求發出快訊。舉例來說，如果特定網址模式的回應時間超過您設定的門檻，您可以為團隊設定電子郵件快訊。

  • 查看使用者工作階段的詳細報表，在其中，您可以在同一個工作階段收集到的其他追蹤記錄的時間軸背景中，查看特定追蹤記錄。