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

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

1. 打開瀏覽器的開發者工具（例如，網絡選項卡為Chrome開發者工具，或在網絡監視器用於Firefox ）。

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

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

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

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

向應用程序添加了 SDK，但控制台仍然說要添加 SDK

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

如果因為你加入了最新版本的SDK到您的應用程序已經超過了10分鐘，你仍然沒有看到任何改變，請檢查您的日誌信息，以確保性能監控記錄事件。嘗試如下所述的適當故障排除步驟來對延遲的 SDK 檢測消息進行故障排除。

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

性能監視在顯示它之前處理性能事件數據的性能儀表板。

如果已經超過24小時，因為“SDK檢測”的消息出現了，你還沒有看到數據，然後檢查火力地堡狀態儀表板的情況下，有一種被稱為中斷。如果沒有中斷，接觸火力地堡支持。

應用未記錄性能事件

如果你沒有看到日誌消息性能事件，請嘗試以下步驟解決問題：

1. 確保性能監測SDK正確初始化在您的應用程序。

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

   • performance.instrumentationEnabled

3. 請確保您的瀏覽器緩存被禁用，否則瀏覽器可能不接任何新的儀器設置。

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

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

5. 如果你不能找到在您的應用程序，禁用任何接觸火力地堡支持。

性能儀表板缺少首次輸入延遲數據

如果你不是為了看到數據第一個輸入延遲指標，請嘗試以下步驟解決問題：

1. 要知道，只有性能監控記錄時，頁面加載後的前5秒內網頁上的用戶點擊第一個輸入延遲度量。

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

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

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

你看到的性能數據進行自動採集的痕跡，但不是自定義代碼的痕跡？嘗試以下故障排除步驟：

1. 檢查通過儀器化自定義代碼痕跡設置跟踪API ，特別是以下情況：

   • 用於自定義代碼跡線和自定義指標名稱必須滿足下列要求：無前導或尾隨的空白，沒有前導下劃線（ _ ）字符，並且最大長度為32個字符。
   • 必須啟動和停止所有跟踪。不會記錄任何未啟動、未停止或在啟動前停止的跟踪。

   請注意，如果您使用的record()方法，那麼你並不需要顯式地啟動或停止跟踪。

2. 確保性能監控數據的收集沒有被禁止通過以下標誌：

   • performance.dataCollectionEnabled

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

3. 檢查你的日誌信息，以確保性能監控記錄有望自定義代碼的痕跡。

4. 如果性能監控是記錄事件，但沒有數據顯示24小時後，接觸火力地堡支持。

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

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

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

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

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

了解更多關於如何性能監控聚集網絡請求數據下的URL模式。

你也可以嘗試定制URL模式！

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

我們重新設計了火力地堡控制台的性能監控部分，使儀表盤選項卡顯示你的關鍵指標，並在一個空間內所有的痕跡。由於重新設計的一部分，我們去掉了對設備和網絡頁面。

在儀表板選項卡底部的痕跡表有所有相同的信息是，在設備和網絡選項卡中顯示，但增加了一些功能，包括由百分比變化為一個具體的指標進行你的痕跡排序。要查看所有特定跟踪的指標和數據，在痕跡表點擊跟踪名稱。

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

• 網絡請求的痕跡（包括外的開箱和自定義） -網絡請求子選項卡
• 自定義代碼的痕跡-自定義痕跡子標籤
• 應用啟動，應用功能於前台，應用功能於背景的痕跡-自定義痕跡子標籤
• 畫面渲染的痕跡-畫面渲染子標籤
• 頁面加載的痕跡-網頁加載子選項卡

有關痕跡表和細節觀察指標和數據，請訪問控制台概述頁面（ iOS版+ |安卓|網站）。

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

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

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

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

• 使用命名空間庫
• 減少您的 SDK 包大小
• 將 SDK 的初始化延遲到您的頁面加載之後

要在您的應用程序中包含獨立的性能監控 SDK 並將其初始化延遲到您的頁面加載後：

1. 將以下腳本添加到索引文件的標題中。
2. 確保為您應用的火力地堡項目配置對象。

(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);

在哪裡，

• performance_standalone是'https://www.gstatic.com/firebasejs/9.6.0/firebase-performance-standalone.js'
• firebaseConfig是您的應用程序的火力地堡配置對象

上面的腳本異步加載，然後獨立SDK窗口的初始化後火力地堡onload事件觸發。這種策略減少了SDK可能對影響頁面加載的指標，因為瀏覽器已經報告了其負荷指標，當你初始化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);

“近乎實時”的性能數據是什麼意思？

Firebase 性能監控進程收集性能數據，從而在 Firebase 控制台中近乎實時地顯示數據。處理過的數據會在收集後的幾分鐘內顯示在控制台中，因此稱為“近乎實時”。

要充分利用接近實時的數據處理，請確保您的應用程序使用一個實時兼容的SDK版本。

如何為我的應用獲取近乎實時的性能數據？

要利用近乎實時的數據處理，您只需確保您的應用使用與實時數據處理兼容的性能監控 SDK 版本。

這些是實時兼容的 SDK 版本：

• iOS版- V7.3.0或更高版本
• tvOS - v8.9.0或更高版本
• Android的- v19.0.10或更高版本（或者Android的火力地堡的物料清單v26.1.0或更高版本）
• 網站- v7.14.0或更高版本

請注意，我們始終建議使用最新版本的 SDK，但上面列出的任何版本都將使性能監控能夠近乎實時地處理您的數據。

哪些版本的性能監控 SDK 被認為是實時兼容的？

這些是與實時數據處理兼容的 SDK 版本：

• iOS版- V7.3.0或更高版本
• tvOS - v8.9.0或更高版本
• Android的- v19.0.10或更高版本（或者Android的火力地堡的物料清單v26.1.0或更高版本）
• 網站- v7.14.0或更高版本

請注意，我們始終建議使用最新版本的 SDK，但上面列出的任何版本都將使性能監控能夠近乎實時地處理您的數據。

如果我不更新我的應用程序以使用實時兼容的 SDK 版本怎麼辦？

如果您的應用未使用實時兼容的 SDK 版本，您仍會在 Firebase 控制台中看到所有應用的性能數據。但是，性能數據的顯示將在其收集時延遲大約 36 小時。

我已經更新到實時兼容的 SDK 版本，但我的一些用戶仍在使用我的應用程序的舊版本。我是否會繼續在 Firebase 控制台中看到他們的性能數據？

是的！無論應用實例使用哪個 SDK 版本，您都會看到所有用戶的性能數據。

不過，如果你正在尋找最新的數據（比約36小時歲以下），則顯示的數據是使用實時兼容的SDK版本的應用程序實例的用戶。非近期的數據，但是，包括從你的應用的所有版本的性能數據。