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

效能監控使用追蹤來收集有關應用程式中受監控進程的資料。追蹤是包含應用程式中兩個時間點之間捕獲的數據的報告。

對於所有應用程式類型,效能監控會自動收集應用程式發出的每個網路請求的追蹤訊息,稱為HTTP/S 網路請求追蹤。這些追蹤收集應用程式向服務端點發出請求與該端點的回應完成之間的時間間隔的指標。對於您的應用程式發出請求的任何端點,效能監控會捕獲多個指標:

  • 回應時間 - 發出請求和完全收到回應之間的時間

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

  • 請求負載大小 - 應用程式上傳的網路負載的位元組大小

  • 成功率 - 成功回應(回應碼在 100 - 399 範圍內)與總回應的百分比

您可以在追蹤表的網路請求子標籤中查看這些追蹤的數據,該表位於效能儀表板的底部(稍後將詳細了解如何使用控制台)。

效能監控自動收集使用下列網路庫的網路請求的指標:

自訂網路請求資料聚合

除了網路請求的開箱即用工具和資料聚合之外,效能監控還支援以下選項:

  • 手動偵測網路請求追蹤:開箱即用的監控包括應用程式的大多數網路請求。但是,某些請求可能不會被報告,或者您可能使用不同的庫來發出網路請求。在這些情況下,您可以使用效能監控 API 手動偵測自訂網路請求追蹤
  • 聚合自訂網址模式下的資料:如果 Firebase 未透過其派生的自動網址模式匹配捕獲特定網址,您可以建立自訂網址模式來監控一段時間內的一組特定網址。
  • 自訂成功率的計算方式:有時,某些 API 端點需要錯誤程式碼,或已在您的應用程式中處理。在這些情況下,您可以配置成功率的計算方式並更準確地監控應用程式網路呼叫的成功率。

URL模式下的資料聚合

Firebase 效能監控會自動聚合類似網路請求的數據,以協助您了解網路請求效能的趨勢。

對於每個請求,Firebase 都會檢查網路請求的 URL 是否與 URL 模式相符。如果請求網址與網址模式匹配,Firebase 會自動根據該網址模式聚合請求的資料。 Firebase 在 Firebase 控制台效能儀表板「網路」標籤中顯示 URL 模式及其聚合資料。

什麼是 URL 模式?

URL 模式包含一個網域以及一個可以符合 URL 路徑的模式,例如: example.com/*/animals/**

  • URL 模式可以包含以下路徑段:

    • 純文字 — 符合精確的字串
    • * — 符合單一路徑段中的任何字串
    • ** — 符合任意路徑後綴
  • URL 模式可以是:

例如:以下任何 URL 請求都可以與 URL 模式example.com/*/animals/**相符。

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

URL 模式的網域也可以包含*作為其第一段,例如: *.example.com/*/fruits/**

Firebase 將每個請求僅對應到一種 URL 模式。如果您配置了任何自訂網址模式,Firebase 會先嘗試將請求網址與這些模式進行比對。如果 Firebase 找不到符合的自訂 URL 模式,則會將請求 URL 與最具代表性的自動 URL 模式進行比對。在以下部分中了解更多有關自動和自訂 URL 模式的資訊。

自動 URL 模式

無需您進行任何配置,效能監控就會嘗試透過將應用程式的請求與自動 URL 模式進行配對來反映應用程式的最新使用行為。

自動 URL 模式比對如何運作?

Firebase 將每個請求與其從應用程式發送的請求派生的最具代表性的自動 URL 模式進行比對。但請注意,Firebase 首先會嘗試將請求 URL 與任何已設定的自訂 URL 模式進行比對。

以下是 Firebase 如何嘗試將請求與應用程式最具代表性的自動 URL 模式相匹配的基本範例。

  1. 您的應用程式會向 URL 發送許多請求,例如:

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

    Firebase 確定example.com/germany/**是您的應用程式的常見請求模式,並將其新增為專案中的自動 URL 模式。

    對於任何與此 URL 模式匹配的請求,Firebase 都會在自動 URL 模式example.com/germany/**下聚合請求的資料。

  2. 一星期後,應用程式的大部分請求都發送到example.com/germany/animals/bearsexample.com/germany/animals/birds 。因此,Firebase 派生出更具代表性的 URL 模式example.com/germany/animals/**

    對於與此新 URL 模式相符的任何請求,Firebase在新 URL 模式下聚合請求的資料。 Firebase 繼續聚合example.com/germany/**下的example.com/germany/cars請求資料。

  3. 但是,在接下來的幾週內,您的應用程式對example.com/germany/animals/bearsexample.com/germany/animals/birds的請求將大幅減少。 Firebase 確定example.com/germany/animals/**不代表您應用的最新使用行為,因此 Firebase 開始將這兩個請求匹配回example.com/germany/**

    Firebase 不會在example.com/germany/animals/**下聚合任何進一步的請求數據,因為它不再是最具代表性的自動 URL 模式。

由於自動 URL 模式比對是動態的,因此請注意以下事項:

  • 先前請求的匹配和聚合資料不受新 URL 模式的影響。 Firebase 不會追溯性地重新聚合請求資料。

  • 只有未來的請求才會受到新 URL 模式的影響。 Firebase 將每個請求對應到最具代表性的自動 URL 模式。但請注意,Firebase 首先會嘗試將請求 URL 與任何已設定的自訂 URL 模式進行比對。

查看自動 URL 模式及其數據

Firebase 在追蹤表的網路請求子標籤中顯示所有 URL 模式及其聚合數據,該表位於 Firebase 控制台效能儀表板的底部。

您可能會看到帶有「未分類」標籤的 URL 模式。這些是「廣泛」的自動 URL 模式,Firebase 可以在這些模式下聚合與任何更具體的 URL 模式不匹配的請求的資料。

當在 URL 模式下聚合的資料的資料保留期結束時,Firebase 會從 URL 模式中刪除該資料。如果自動 URL 模式下聚合的所有資料都已過期,Firebase 將從 Firebase 控制台中刪除該 URL 模式。

自訂 URL 模式

您可以建立自訂網址模式來監控 Firebase 未透過其派生的自動網址模式來匹配捕獲的特定網址模式。例如,您可以使用自訂 URL 模式對特定 URL 進行故障排除或隨著時間的推移監控一組特定的 URL。

請造訪建立自訂 URL 模式以了解更多資訊。

追蹤、查看和過濾性能數據

若要查看即時效能數據,請確保您的應用程式使用與即時數據處理相容的效能監控 SDK 版本。了解有關即時性能數據的更多資訊

追蹤儀表板中的特定指標

若要了解關鍵指標的趨勢,請將它們新增至績效儀表板頂部的指標板。您可以透過查看每週的變更來快速識別回歸,或者驗證程式碼中的最新變更是否正在提高效能。

Firebase 效能監控儀表板中指標板的影像

若要將指標新增至指標板,請執行下列步驟:

  1. 前往 Firebase 控制台中的效能儀表板
  2. 點擊空指標卡,然後選擇現有指標以新增到您的看板中。
  3. 點擊填滿的指標卡上的可取得更多選項,例如取代或刪除指標。

指標板以圖形形式和數字百分比變化的形式顯示隨時間推移收集的指標資料。

了解有關使用儀表板的更多資訊。

查看踪跡及其數據

若要查看跟踪,請前往 Firebase 控制台中的效能儀表板,向下捲動至追蹤表,然後按一下對應的子標籤。該表顯示每個追蹤的一些主要指標,您甚至可以按特定指標的百分比變化對清單進行排序。

效能監控在 Firebase 控制台中提供了一個故障排除頁面,突出顯示了指標更改,從而可以輕鬆快速解決效能問題並最大程度地減少其對應用程式和使用者的影響。當您了解潛在的效能問題時,您可以使用故障排除頁面,例如,在以下場景中:

  • 您在儀表板上選擇相關指標,您會注意到一個很大的增量。
  • 在追蹤表中,您進行排序以在頂部顯示最大增量,並且您會看到顯著的百分比變化。
  • 您會收到一封電子郵件警報,通知您出現效能問題。

您可以透過以下方式進入故障排除頁面:

  • 在指標儀表板上,按一下查看指標詳細資訊按鈕。
  • 在任何度量卡上,選擇 => 查看詳情。故障排除頁面顯示有關您選擇的指標的資訊。
  • 在追蹤表中,按一下追蹤名稱或與該追蹤關聯的行中的任何指標值。
  • 在電子郵件警報中,按一下立即調查

當您按一下追蹤表中的追蹤名稱時,您可以深入了解感興趣的指標。點選過濾器按鈕可按屬性過濾數據,例如:

按屬性過濾的 Firebase 效能監控資料的影像
  • 應用程式版本過濾以查看有關過去版本或最新版本的數據
  • 裝置過濾以了解舊裝置如何處理您的應用
  • 按國家/地區過濾以確保您的資料庫位置不會影響特定區域

了解有關查看追蹤數據的更多資訊。

下一步

  • 了解有關使用屬性檢查效能資料的詳細資訊。

  • 詳細了解如何在 Firebase 控制台中追蹤效能問題

  • 針對降低應用程式效能的網路請求設定警報。例如,如果特定 URL 模式的回應時間超過您設定的閾值,您可以為您的團隊設定電子郵件警報。

  • 查看使用者會話的詳細報告,您可以在其中看到同一會話期間收集的其他追蹤的時間軸上下文中的特定追蹤。