Rozwiązywanie problemów z monitorowaniem wydajności i najczęstsze pytania

Jak wyświetlać komunikaty z dziennika dotyczące zdarzeń związanych z wydajnością

1. Otwórz narzędzia dla programistów w przeglądarce (np. kartę Network (Sieć) w Narzędziach deweloperskich w Chrome lub Network Monitor w Firefoksie).

2. Odśwież aplikację internetową w przeglądarce.

3. Sprawdź, czy w komunikatach logu nie ma żadnych komunikatów o błędach.

4. Po kilku sekundach poszukaj w narzędziach dla programistów w przeglądarce wywołania sieciowego do firebaselogging.googleapis.com. Obecność tego wywołania sieci wskazuje, że przeglądarka wysyła dane o wydajności do Firebase.

Jeśli aplikacja nie rejestruje zdarzeń dotyczących wydajności, zapoznaj się ze wskazówkami dotyczącymi rozwiązywania problemów.

Pakiet SDK został dodany do aplikacji, ale w konsoli nadal pojawia się komunikat o konieczności dodania pakietu SDK

Firebase może wykryć, czy do aplikacji Performance Monitoring dodano pakiet SDK, gdy otrzyma z niej informacje o zdarzeniach (np. interakcjach z aplikacją). Zazwyczaj w ciągu 10 minut od uruchomienia aplikacji na stronie Wydajność konsoli konsoli Firebase pojawi się komunikat „Wykryto pakiet SDK”. Następnie w ciągu 30 minut w panelu wyświetli się wstępnie przetworzone dane.

Jeśli od dodania najnowszej wersji pakietu SDK do aplikacji minęło ponad 10 minut i wciąż nie widzisz żadnych zmian, sprawdź komunikaty logu i upewnij się, że Performance Monitoring rejestruje zdarzenia. Aby rozwiązać problem z wiadomością dotyczącą opóźnionego wykrywania opóźnionego pakietu SDK, wykonaj opisane poniżej czynności.

Konsola informuje, że pakiet SDK został wykryty, ale nie wyświetla żadnych danych

Performance Monitoring przetwarza dane zdarzenia wydajności, zanim wyświetli je w panelu Skuteczność.

Jeśli od pojawienia się komunikatu „Wykryto pakiet SDK” minęło ponad 24 godziny, a nadal nie widzisz danych, sprawdź panel stanu Firebase, aby się dowiedzieć, czy nie ma tam żadnej znanej awarii. Jeśli nie ma przerwy w działaniu usługi, skontaktuj się z zespołem pomocy Firebase.

Aplikacja nie loguje zdarzeń dotyczących wydajności

Jeśli nie widzisz komunikatów dziennika dotyczących zdarzeń wydajności, wykonaj te czynności:

1. Upewnij się, że pakiet SDK Performance Monitoring został zainicjowany w aplikacji.

2. Upewnij się, że pakiet SDK Performance Monitoring nie jest wyłączony za pomocą tej flagi:

   • performance.instrumentationEnabled

3. Upewnij się, że buforowanie przeglądarki jest wyłączone, ponieważ w przeciwnym razie przeglądarka może nie uwzględnić żadnych nowych ustawień pomiarów.

4. Zamknij i ponownie otwórz kartę strony internetowej. Sprawdź, czy logowanie zostało wykonane ponownie.

   Jeśli pakiet SDK Performance Monitoring został niedawno dodany do aplikacji, może być konieczne jej ponowne uruchomienie, aby pakiet SDK mógł działać.

5. Jeśli nie możesz znaleźć w aplikacji niczego, co jest wyłączone, skontaktuj się z zespołem pomocy Firebase.

W panelu wydajności brakuje danych dotyczących opóźnienia pierwszego wejścia

Jeśli nie widzisz danych dotyczących danych o opóźnieniu przy pierwszym działaniu, wykonaj te czynności, aby rozwiązać problem:

1. Pamiętaj, że Performance Monitoring rejestruje dane o opóźnieniu przy pierwszym działaniu tylko wtedy, gdy użytkownik kliknie stronę internetową w ciągu pierwszych 5 sekund po jej wczytaniu.

2. Aby mierzyć te dane, musisz skonfigurować aplikację. Dane o opóźnieniu przy pierwszym działaniu wymagają ręcznej konfiguracji. W szczególności musisz dodać bibliotekę polyfill dla tych danych. Instrukcje instalacji znajdziesz w dokumentacji biblioteki.

   Pamiętaj, że do raportowania innych danych o aplikacji internetowej nie jest wymagane dodawanie tej biblioteki polyfill.

W panelu skuteczności brakuje danych z niestandardowego śledzenia

Czy widzisz dane o wydajności logów zbieranych automatycznie, ale nie niestandardowych logów czasu? Wypróbuj te rozwiązania:

1. Sprawdź konfigurację ścieżek kodu niestandardowego zinstrumentowanego za pomocą Trace API, w szczególności:

   • Nazwy ścieżek niestandardowego kodu i danych niestandardowych muszą spełniać te wymagania: nie mogą zawierać spacji na początku ani na końcu, nie mogą zaczynać się od znaku podkreślenia (_), a ich maksymalna długość to 32 znaki.
   • Wszystkie logi czasu muszą być uruchomione i zatrzymane. Każdy log czasu, który nie został rozpoczęty, nie został zatrzymany lub został zatrzymany przed rozpoczęciem, nie będzie logowany.

   Pamiętaj, że jeśli używasz metody record(), nie musisz jawnie rozpoczynać ani zatrzymywać śledzenia.

2. Sprawdź, czy gromadzenie danych w usłudze Performance Monitoring nie jest wyłączone za pomocą tej flagi:

   • performance.dataCollectionEnabled

     Ta flaga kontroluje zbieranie danych tylko na potrzeby niestandardowego śledzenia kodu (a nie wszystkich danych).

3. Sprawdź komunikaty w logach, aby się upewnić, że Performance Monitoring rejestruje oczekiwane ścieżki kodu niestandardowego.

4. Jeśli Performance Monitoring rejestruje zdarzenia, ale po 24 godzinach nie wyświetlają się żadne dane, skontaktuj się z zespołem pomocy Firebase.

W panelu skuteczności brakuje danych o żądaniach sieci

Jeśli brakuje Ci danych żądania sieci, pamiętaj o tych kwestiach:

• Performance Monitoring automatycznie zbiera dane dotyczące żądań sieciowych zgłaszanych przez interfejs API przeglądarki. Raporty te nie obejmują nieudanych żądań sieciowych.

• W zależności od zachowania kodu i bibliotek sieciowych używanych przez kod Performance Monitoring może raportować tylko zakończone żądania sieciowe. Oznacza to, że pozostawione otwarte połączenia HTTP/S mogą nie zostać zgłoszone.

Dane żądań sieciowych nie agregują się w oczekiwany sposób

Dowiedz się więcej o tym, jak Performance Monitoring agreguje dane dotyczące żądań sieciowych w ramach wzorów adresów URL.

Możesz też wypróbować niestandardowe wzorce adresów URL.

Co się stało z kartą Najważniejsze problemy na karcie Wyniki na stronie głównej projektu?

Zastąpiliśmy sekcję Najważniejsze problemy Najnowszymi alertami w związku z niedawnym wprowadzeniem alertów, które automatycznie powiadamiają Cię o przekroczeniu ustawionych przez Ciebie progów. Problemy zostały wycofane i zastąpione alertami.

Selektor aplikacji u góry karty Skuteczność filtruje alerty w sekcji Najnowsze alerty. Wyświetlane są tylko 3 ostatnie alerty dotyczące wybranych aplikacji.

Więcej informacji o alertach znajdziesz w artykule Konfigurowanie alertów dotyczących problemów z wydajnością.

Co się stało z możliwością ustawiania progów dla problemów w konsoli?

Performance Monitoring obsługuje alerty dotyczące wskaźników przekraczających zdefiniowane progi. Aby uniknąć pomyłek związanych z konfigurowalnymi progami wskaźników wydajności, usunęliśmy możliwość konfigurowania progów w przypadku problemów.

Co się stało z informacjami o szczegółach i danych w konsoli Firebase?

Zastąpiliśmy strony Szczegóły i dane nowym, scentralizowanym interfejsem użytkownika, aby usprawnić rozwiązywanie problemów. Ten nowy interfejs do rozwiązywania problemów oferuje te same główne funkcje, które są dostępne w sekcji Szczegóły i Dane. Więcej informacji o rozwiązywaniu problemów znajdziesz w artykule Wyświetlanie dodatkowych danych dotyczących konkretnego śledzenia.

Dlaczego liczba próbek nie jest zgodna z moimi oczekiwaniami?

Performance Monitoring zbiera dane o wydajności z urządzeń użytkowników Twojej aplikacji. Jeśli Twoja aplikacja ma wielu użytkowników lub generuje dużą aktywność, Performance Monitoring może ograniczyć zbieranie danych do podzbioru urządzeń, aby zmniejszyć liczbę przetwarzanych zdarzeń. Te limity są wystarczająco wysokie, aby nawet przy mniejszej liczbie zdarzeń wartości danych nadal odzwierciedlały wrażenia użytkownika związane z aplikacją.

Aby zarządzać ilością gromadzonych danych, Performance Monitoring korzysta z tych opcji próbkowania:

• Ograniczenie szybkości na urządzeniu: aby zapobiec nagłem wysyłaniu przez urządzenie dużej liczby ścieżek, ograniczamy liczbę ścieżek kodu i żądań sieci wysyłanych z urządzenia do 300 zdarzeń na 10 minut. Ta metoda chroni urządzenie przed zapętlanymi instrumentami, które mogą wysyłać duże ilości danych o wydajności, i zapobiega zaburzaniu pomiarów wydajności przez pojedyncze urządzenie.

• Próbkowanie dynamiczne: Performance Monitoring zbiera codziennie ograniczoną liczbę logów czasu kodu i żądań sieciowych na aplikację od wszystkich użytkowników aplikacji. Na urządzeniach pobierana jest dynamiczna częstotliwość próbkowania (za pomocą funkcji Firebase Remote Config), aby określić, czy losowe urządzenie powinno rejestrować i przesyłać ścieżki. Urządzenie, które nie zostało wybrane do próbkowania, nie wysyła żadnych zdarzeń. Dynamiczny współczynnik próbkowania jest specyficzny dla aplikacji i dostosowuje się, aby zapewnić, że łączna objętość zebranych danych nie przekracza limitu.

  Sesje użytkownika wysyłają dodatkowe, szczegółowe dane z urządzenia użytkownika, co wymaga większej ilości zasobów do przechwytywania i wysyłania danych. Aby zminimalizować wpływ sesji użytkowników, Performance Monitoring może też ograniczać liczbę sesji.

• Ograniczenie szybkości po stronie serwera: aby zapobiec przekroczeniu limitu próbkowania przez aplikacje, Performance Monitoring może używać próbkowania po stronie serwera do pomijania niektórych zdarzeń odbieranych z urządzeń. Chociaż tego typu ograniczenie nie zmienia skuteczności naszych danych, może powodować drobne zmiany w wzorcech, w tym:

  • Liczba logów czasu może się różnić od liczby uruchomień fragmentu kodu.
  • Ślady, które są ściśle sprzężone w kodzie, mogą zawierać różną liczbę próbek.

Co się stało z kartą Problemy w konsoli?

Zamiast karty Problemy wprowadziliśmy kartę Ostrzeżenia, która automatycznie wysyła powiadomienia, gdy przekroczone zostaną ustawione przez Ciebie progi. Nie musisz już ręcznie sprawdzać stanu progu w konsoli Firebase. Więcej informacji o alertach znajdziesz w artykule Konfigurowanie alertów o problemach z wydajnością.

Co się stało z kartami Na urządzeniu i Sieć w konsoli? Jak mogę wyświetlić ścieżki na tych stronach?

Zmodyfikowaliśmy sekcję Performance Monitoring w konsoli Firebase, tak aby na karcie Panel wyświetlały się najważniejsze dane i wszystkie logi czasu w jednym miejscu. W ramach zmian usunęliśmy strony Na urządzeniu i Sieć.

Tabela logów czasu u dołu karty Panel zawiera te same informacje, które wyświetlały się na kartach Na urządzeniu i Sieć, ale ma też kilka nowych funkcji, w tym możliwość sortowania logów czasu według zmiany procentowej określonego wskaźnika. Aby wyświetlić wszystkie dane dotyczące konkretnego śledzenia, kliknij jego nazwę w tabeli śledzenia.

Ścieżki możesz wyświetlać na tych podrzędach w tabeli ścieżek:

• Logi czasu żądań sieciowych (zarówno gotowe, jak i niestandardowe) – podkarta Żądania sieciowe
• Ścieżki niestandardowego kodu – karta Ścieżki niestandardowe
• Ścieżki uruchamiania aplikacji, ścieżki aplikacji na pierwszym planie i ścieżki aplikacji działającej w tle – podkarta Ścieżki niestandardowe
• Ślady renderowania ekranu – podkarta Renderowanie ekranu
• Ślady wczytywania strony – podkarta Wczytanie strony

Szczegółowe informacje o tabeli prześledowań oraz wyświetlaniu danych i wskaźników znajdziesz na stronie przeglądu konsoli (iOS+ | Android | Internet).

Dlaczego liczba spowolnionych i zablokowanych klatek jest niezgodna z oczekiwaniami?

Czasy renderowania spowolnionych i zablokowanych klatek są obliczane przy założeniu częstotliwości odświeżania urządzenia 60 Hz. Jeśli częstotliwość odświeżania urządzenia jest niższa niż 60 Hz, każda klatka będzie renderowana wolniej, ponieważ renderuje się mniej klatek na sekundę. Wolniejsze czasy renderowania mogą powodować zgłaszanie większej liczby spowolnionych lub zablokowanych klatek, ponieważ więcej klatek będzie renderowanych wolniej lub zablokowanych. Jeśli jednak częstotliwość odświeżania urządzenia jest większa niż 60 Hz, każda klatka będzie renderowana szybciej. Może to spowodować, że zgłoszonych zostanie mniej ujęć wolnych lub zablokowanych. Jest to obecne ograniczenie w pakiecie SDK Performance Monitoring.

Jak dodać do mojej aplikacji internetowej mniejszy pakiet SDK JS Performance Monitoring z przestrzenią nazw (samodzielny pakiet SDK)?

Jeśli Performance Monitoring to jedyna usługa Firebase w Twojej aplikacji, możesz użyć niezależnego pakietu SDK Performance Monitoring (i zalecanego skryptu nagłówka poniżej), jeśli interesuje Cię:

• za pomocą biblioteki z przestrzenią nazw;
• zmniejszenie rozmiaru pakietu SDK
• opóźnianie inicjowania pakietu SDK do czasu załadowania strony

Aby uwzględnić w swojej aplikacji samodzielny pakiet SDK Performance Monitoring i opóźnić jego inicjalizację do momentu załadowania strony:

1. Dodaj do nagłówka pliku indeksu ten skrypt.
2. Pamiętaj, aby dodać obiekt konfiguracji projektu Firebase aplikacji.

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

Gdzie?

• performance_standalone to: 'https://www.gstatic.com/firebasejs/11.0.1/firebase-performance.js'
• firebaseConfig to obiekt konfiguracyjny Firebase Twojej aplikacji.

Powyższy skrypt asynchronicznie wczytuje samodzielny pakiet SDK, a następnie inicjuje Firebase po uruchomieniu zdarzenia onload w oknie. Ta taktyka zmniejsza wpływ pakietu SDK na dane o wczytywaniu stron, ponieważ przeglądarka przekazuje już dane o wczytywaniu w momencie inicjowania pakietu 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);

Co oznaczają dane o skuteczności aktualizowane w czasie zbliżonym do rzeczywistego?

Firebase Performance Monitoring przetwarza zebrane dane o wydajności na bieżąco, dzięki czemu w konsoli Firebase wyświetlają się dane w czasie zbliżonym do rzeczywistego. Przetworzone dane wyświetlają się w konsoli w ciągu kilku minut od ich zebrania, stąd termin „prawie w czasie rzeczywistym”.

Aby korzystać z przetwarzania danych w czasie zbliżonym do rzeczywistego, upewnij się, że Twoja aplikacja korzysta z wersji pakietu SDK zgodnego z czasem rzeczywistym.

Jak mogę uzyskać dane o skuteczności mojej aplikacji w czasie zbliżonym do rzeczywistego?

Aby korzystać z możliwości przetwarzania danych w czasie zbliżonym do rzeczywistego, musisz tylko upewnić się, że Twoja aplikacja korzysta z wersji pakietu SDK Performance Monitoring, która jest zgodna z przetwarzaniem danych w czasie rzeczywistym.

Oto wersje pakietu SDK, które obsługują działanie w czasie rzeczywistym:

• iOS – wersja 7.3.0 lub nowsza.
• tvOS – wersja 8.9.0 lub nowsza
• Android – wersja 19.0.10 lub nowsza (lub Firebase Android BoM 26.1.0 lub nowsza)
• Wersja internetowa – wersja 7.14.0 lub nowsza

Pamiętaj, że zawsze zalecamy korzystanie z najnowszej wersji pakietu SDK. Każda z wymienionych powyżej wersji umożliwi usłudze Performance Monitoring przetwarzanie danych w czasie zbliżonym do rzeczywistego.

Które wersje pakietu SDK Performance Monitoring są uważane za zgodne w czasie rzeczywistym?

Te wersje pakietu SDK są zgodne z przetwarzaniem danych w czasie rzeczywistym:

• iOS – wersja 7.3.0 lub nowsza
• tvOS – wersja 8.9.0 lub nowsza
• Android – wersja 19.0.10 lub nowsza (lub Firebase Android BoM 26.1.0 lub nowsza)
• Wersja internetowa – wersja 7.14.0 lub nowsza

Pamiętaj, że zawsze zalecamy korzystanie z najnowszej wersji pakietu SDK. Każda z wymienionych powyżej wersji umożliwi usłudze Performance Monitoring przetwarzanie danych w czasie zbliżonym do rzeczywistego.

Co zrobić, jeśli nie zaktualizuję aplikacji, aby używała wersji pakietu SDK zgodnej z czasem rzeczywistym?

Jeśli Twoja aplikacja nie korzysta z wersji pakietu SDK zgodnej z czasem rzeczywistym, wszystkie dane o jej wydajności nadal będziesz widzieć w konsoli Firebase. Wyświetlenie danych o skuteczności będzie jednak opóźnione o około 36 godzin od momentu ich zebrania.

Zaktualizowałem/zaktualizowałam pakiet SDK do wersji zgodnej z czasem rzeczywistym, ale niektórzy użytkownicy nadal korzystają ze starszych wersji aplikacji. Czy nadal będę widzieć dane o jej działaniu w konsoli Firebase?

Tak. Niezależnie od tego, z której wersji pakietu SDK korzysta instancja aplikacji, zobaczysz dane o wydajności wszystkich użytkowników.

Jeśli jednak przeglądasz najnowsze dane (są sprzed mniej niż 36 godzin), wyświetlane dane pochodzą od użytkowników instancji aplikacji korzystających z wersji pakietu SDK zgodnej w czasie rzeczywistym. Niedawne dane obejmują jednak dane o skuteczności ze wszystkich wersji aplikacji.