性能監控故障排除和常見問題解答

如何查看性能事件的日誌消息

1. 打開瀏覽器的開發人員工具（例如， Chrome 開發工具的網絡選項卡或Firefox 的網絡監視器）。

2. 在瀏覽器中刷新您的 Web 應用程序。

3. 檢查您的日誌消息是否有任何錯誤消息。

4. 幾秒鐘後，在瀏覽器的開發人員工具中查找對firebaselogging.googleapis.com網絡調用。該網絡調用的存在表明瀏覽器正在向 Firebase 發送性能數據。

如果您的應用未記錄性能事件，請查看故障排除提示。

已將 SDK 添加到應用程序，但控制台仍顯示添加 SDK

當 Firebase 從您的應用程序接收事件信息（如應用程序交互）時，它可以檢測您是否已成功將性能監控 SDK 添加到您的應用程序。通常在啟動您的應用程序後 10 分鐘內，Firebase 控制台的性能儀表板會顯示“檢測到 SDK”消息。然後，在 30 分鐘內，儀表板會顯示初始處理的數據。

如果您將最新版本的 SDK 添加到您的應用程序已經超過 10 分鐘，並且您仍然沒有看到任何更改，請檢查您的日誌消息以確保性能監控正在記錄事件。嘗試如下所述的適當故障排除步驟來解決延遲 SDK 檢測消息的問題。

控制台顯示檢測到 SDK，但沒有顯示任何數據

性能監控先處理性能事件數據，然後再將其顯示在性能儀表板中。

如果自“檢測到 SDK”消息出現以來已超過 24 小時，而您仍未看到數據，請檢查Firebase 狀態儀表板以防已知中斷。如果沒有中斷，請聯繫 Firebase 支持。

應用程序未記錄性能事件

如果您沒有看到性能事件的日誌消息，請嘗試以下故障排除步驟：

1. 請確保性能監控 SDK 在您的應用中已正確初始化。

2. 確保未通過以下標誌禁用性能監控 SDK：

   • performance.instrumentationEnabled

3. 確保禁用瀏覽器緩存，否則瀏覽器可能無法獲取任何新的檢測設置。

4. 關閉，然後重新打開網頁選項卡。再次檢查日誌記錄。

   如果您剛剛在您的應用程序中添加了性能監控 SDK，您可能需要完全重啟您的應用程序，SDK 才能開始工作。

5. 如果您在您的應用中找不到任何被禁用的內容，請聯繫 Firebase 支持。

性能儀表板缺少第一個輸入延遲數據

如果您沒有看到第一個輸入延遲指標的數據，請嘗試以下故障排除步驟：

1. 請注意，當用戶在頁面加載後的前 5 秒內單擊網頁時，性能監控僅記錄第一個輸入延遲指標。

2. 確保您已將應用設置為衡量此指標。第一個輸入延遲指標需要手動設置。具體來說，您需要為此指標添加 polyfill 庫。有關安裝說明，請參閱庫的文檔。

   請注意，性能監控不需要添加此 polyfill 庫來報告其他 Web 應用指標。

性能儀表板缺少自定義跟踪數據

您看到的是自動收集的跟踪的性能數據，而不是自定義代碼跟踪的性能數據嗎？請嘗試以下故障排除步驟：

1. 檢查通過Trace API檢測的自定義代碼跟踪的設置，尤其是以下內容：

   • 自定義代碼跟踪和自定義指標的名稱必須滿足以下要求：沒有前導或尾隨空格，沒有前導下劃線 ( _ ) 字符，最大長度為 32 個字符。
   • 必須啟動和停止所有跟踪。任何未啟動、未停止或在啟動前停止的跟踪都不會被記錄。

   請注意，如果您使用的是record()方法，則無需顯式啟動或停止跟踪。

2. 確保未通過以下標誌禁用性能監控數據收集：

   • performance.dataCollectionEnabled

     此標誌僅控制自定義代碼跟踪的數據收集（不是所有數據）。

3. 檢查您的日誌消息以確保性能監控正在記錄預期的自定義代碼跟踪。

4. 如果 Performance Monitoring 正在記錄事件，但 24 小時後沒有顯示任何數據，請聯繫 Firebase 支持。

性能儀表板缺少網絡請求數據

如果您缺少網絡請求數據，請注意以下事項：

• 性能監控自動收集瀏覽器 API 報告的網絡請求指標。這些報告不包括失敗的網絡請求。

• 根據代碼的行為和代碼使用的網絡庫，性能監控可能只報告已完成的網絡請求。這意味著可能不會報告保持打開狀態的 HTTP/S 連接。

網絡請求數據未按預期聚合

詳細了解性能監控如何根據 URL 模式聚合網絡請求數據。

您還可以嘗試自定義 URL 模式！

Project 主頁上性能卡中的熱門問題發生了什麼變化？

我們用最近的警報替換了熱門問題，作為我們最近引入的警報的後續行動，警報會在超過您設置的閾值時自動通知您。問題現在已棄用並由警報取代。

Performance 卡頂部的應用程序選擇器過濾Recent Alerts下的警報條目。僅顯示所選應用程序的三個最新警報。

要了解有關警報的更多信息，請參閱為性能問題設置警報。

在控制台中為問題設置閾值的能力發生了什麼變化？

性能監控支持對超過定義閾值的指標發出警報。為了避免與性能指標的這些可配置閾值混淆，我們刪除了為問題配置閾值的功能。

Firebase 控制台中的 Details 和 Metrics 信息發生了什麼變化？

我們用重新設計的集中式用戶界面 (UI) 替換了詳細信息和指標頁面，以改進您解決問題的方式。這個新的故障排除 UI 提供了與 Details 和 Metrics 提供的相同的核心功能。要了解有關故障排除的更多信息，請參閱查看特定跟踪的更多數據。

為什麼樣本數量不是我期望的？

性能監控從您應用的用戶設備收集性能數據。如果您的應用程序有很多用戶，或者如果應用程序生成大量性能活動，性能監控可能會將數據收集限制在一部分設備上，以減少已處理事件的數量。這些限制足夠高，因此即使事件較少，指標值仍能代表用戶的應用程序體驗。

為了管理我們收集的數據量，性能監控使用以下採樣選項：

• 設備上速率限制：為防止設備突然發送大量跟踪，我們將設備發送的代碼和網絡請求跟踪的數量限制為每 10 分鐘 300 個事件。這種方法可以保護設備免受可以發送大量性能數據的循環儀器的影響，並防止單個設備扭曲性能測量。

• 動態採樣：性能監控為所有應用程序用戶收集每個應用程序大約 1 億個代碼跟踪事件和 1 億個網絡請求跟踪事件。在設備上獲取動態採樣率（使用 Firebase 遠程配置）以確定隨機設備是否應捕獲和發送跟踪。未被選中進行採樣的設備不會發送任何事件。動態採樣率是特定於應用程序的，並會進行調整以確保收集的數據總量保持在限制以下。

  用戶會話從用戶設備發送額外的詳細數據，需要更多資源來捕獲和發送數據。為了最大限度地減少用戶會話的影響，性能監控可能還會限制會話數。

• 服務器端速率限制：為確保應用程序不超過採樣限制，性能監控可能會使用服務器端採樣來丟棄從設備接收的一些事件。雖然這種類型的限制不會改變我們指標的有效性，但它可能會導致輕微的模式轉變，包括以下內容：

  • 跟踪的數量可能不同於一段代碼被執行的次數。
  • 在代碼中緊密耦合的跟踪可能各自具有不同數量的樣本。

控制台中的“問題”選項卡發生了什麼變化？

我們通過引入警報取代了“問題”選項卡，當超過您設置的閾值時，它會自動通知您。您不再需要手動檢查 Firebase 控制台來確定閾值的狀態。要了解警報，請參閱設置性能問題警報。

控制台中的“設備上”和“網絡”選項卡發生了什麼變化？我如何查看那些頁面上的痕跡？

我們重新設計了 Firebase 控制台的性能監控部分，以便“儀表板”選項卡在一個空間中顯示您的關鍵指標和所有跟踪記錄。作為重新設計的一部分，我們刪除了“在設備上”和“網絡”頁面。

“儀表板”選項卡底部的跟踪表具有與“設備上”和“網絡”選項卡顯示的所有相同信息，但增加了一些功能，包括能夠按特定指標的百分比變化對跟踪進行排序。要查看特定跟踪的所有指標和數據，請單擊跟踪表中的跟踪名稱。

在跟踪表的以下子選項卡中查看您的跟踪：

• 網絡請求跟踪（現成的和自定義的）——網絡請求子選項卡
• 自定義代碼跟踪 -自定義跟踪子選項卡
• 應用程序啟動、應用程序在前台、應用程序在後台跟踪 —自定義跟踪子選項卡
• 屏幕渲染痕跡 -屏幕渲染子選項卡
• 頁面加載跟踪 -頁面加載子選項卡

有關跟踪表和查看指標和數據的詳細信息，請訪問控制台概述頁面 ( iOS+ | Android | Web )。

為什麼緩慢和凍結的幀數不是我預期的？

慢速渲染幀和凍結幀是使用 60Hz 的假定設備刷新率計算的。如果設備刷新率低於 60Hz，則每幀的渲染時間都會變慢，因為每秒渲染的幀數會減少。較慢的渲染時間會導致報告更慢或凍結的幀，因為更多的幀將被渲染得更慢或凍結。但是，如果設備刷新率高於 60Hz，則每一幀的渲染時間都會更快。這可能會導致報告的慢幀或凍結幀更少。這是性能監控 SDK 中的當前限制。

如何將較小的命名空間 Performance Monitoring JS SDK（“獨立”SDK）添加到我的 Web 應用程序？

如果 Performance Monitoring 是您應用中​​唯一的 Firebase 產品，您可以使用獨立的 Performance Monitoring SDK（以及下面推薦的標頭腳本），前提是您對以下方面感興趣：

• 使用命名空間庫
• 減少您的 SDK 包大小
• delaying initialization of the SDK until after your page loads

To include the standalone Performance Monitoring SDK in your app and delay its initialization to after your page loads:

1. Add the following script to the header of your index file.
2. Make sure to add your app's Firebase project configuration object .

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

where,

• performance_standalone is 'https://www.gstatic.com/firebasejs/9.22.1/firebase-performance-standalone.js'
• firebaseConfig is your app's Firebase config object

The above script asynchronously loads the standalone SDK then initializes Firebase after the window's onload event fires. This tactic reduces the impact that the SDK could have on page load metrics since the browser has already reported its loading metrics when you initialize the SDK.

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

I've updated to a real-time compatible SDK version, but some of my users are still on old versions of my app. Do I continue to see their performance data in the Firebase console?

Yes! Regardless of which SDK version an app instance uses, you'll see performance data from all your users.

However, if you're looking at recent data (less than roughly 36 hours old), then the displayed data is from users of app instances using a real-time compatible SDK version. The non-recent data, though, includes performance data from all versions of your app.