Rozwiązywanie problemów z monitorowaniem wydajności i najczęstsze pytania
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz wskazówki dotyczące rozwiązywania problemów, które pomogą Ci zacząć korzystać z Performance Monitoring lub funkcji i narzędzi Performance Monitoring.
Pierwsze kroki w rozwiązywaniu problemów
Poniższe 2 sprawdzone metody są zalecane wszystkim użytkownikom przed podjęciem dalszych działań.
1. Sprawdzanie wiadomości w dzienniku pod kątem zdarzeń związanych z wydajnością
Sprawdź wiadomości w logach, aby upewnić się, że pakiet SDK Performance Monitoring rejestruje zdarzenia związane z wydajnością.
Wyświetlanie wiadomości logu dotyczących zdarzeń związanych z wydajnością
Sprawdź, czy w komunikatach dziennika nie ma żadnych komunikatów o błędach.
Po kilku sekundach poszukaj w narzędziach deweloperskich przeglądarki wywołania sieciowego do
firebaselogging.googleapis.com. Obecność tego wywołania sieciowego oznacza, że przeglądarka wysyła dane o wydajności do Firebase.
Sprawdź Panel stanu Firebase, jeśli występuje znana przerwa w działaniu Firebase lub Performance Monitoring.
Rozpoczęcie pracy z Performance Monitoring
Jeśli dopiero zaczynasz korzystać z Performance Monitoring (iOS+ | Android | Internet), poniższe wskazówki dotyczące rozwiązywania problemów mogą okazać się pomocne w przypadku problemów z wykrywaniem zestawu SDK przez Firebase lub wyświetlaniem pierwszych danych dotyczących wydajności w konsoli Firebase.
Pakiet SDK został dodany do aplikacji, ale konsola nadal wyświetla komunikat o konieczności dodania pakietu SDK
Firebase może wykryć, czy pomyślnie dodanoPerformance Monitoring SDK do Twojej aplikacji, gdy otrzyma z niej informacje o zdarzeniach (takie jak interakcje z aplikacją). Zwykle w ciągu 10 minut od uruchomienia aplikacjiWydajność panel zFirebase Konsola wyświetla komunikat „Wykryto zestaw SDK”. W ciągu 30 minut w panelu pojawią się wstępnie przetworzone dane.
Jeśli minęło ponad 10 minut od dodania najnowszej wersji zestawu SDK do aplikacji i nadal nie widzisz żadnych zmian, sprawdź komunikaty dziennika, aby upewnić się, że Performance Monitoring rejestruje zdarzenia. Aby rozwiązać problem z opóźnionym komunikatem o wykryciu pakietu SDK, wykonaj odpowiednie czynności opisane poniżej.
Aplikacja rejestruje zdarzenia: kroki rozwiązywania problemów
Jeśli nadal rozwijasz się lokalnie, spróbuj wygenerować więcej zdarzeń w celu zbierania danych:
Udostępniaj i przeglądaj swoją aplikację internetową w środowisku lokalnym.
Generuj zdarzenia poprzez ładowanie podstron swojej witryny, interakcję z aplikacją i/lub wyzwalanie żądań sieciowych. Pamiętaj, aby pozostawić kartę przeglądarki otwartą przez co najmniej 10 sekund po załadowaniu strony.
Upewnij się, że obiekt konfigurujący Firebase został prawidłowo dodany do aplikacji i że nie został zmodyfikowany. Sprawdź konkretnie następujące kwestie:
Identyfikator aplikacji internetowej Firebase (appId ) w obiekcie konfiguracyjnym jest poprawny dla Twojej aplikacji. Znajdź swój identyfikator aplikacji Firebase wTwoje aplikacje Twoja kartasettingsUstawienia projektu.
Jeśli coś wydaje się nie tak z obiektem konfiguracyjnym w Twojej aplikacji, wypróbuj następujące rozwiązanie:
Usuń obiekt konfiguracyjny, który obecnie znajduje się w Twojej aplikacji.
Aby uzyskać nowy obiekt konfiguracji i dodać go do aplikacji internetowej, wykonaj te instrukcje.
Jeśli zestaw SDK rejestruje zdarzenia i wszystko wydaje się być skonfigurowane poprawnie, ale nadal nie widzisz komunikatu o wykryciu zestawu SDK ani przetworzonych danych (po 2 godzinach), skontaktuj się z pomocą techniczną Firebase.
Aplikacja nie rejestruje zdarzeń: kroki rozwiązywania problemów
Upewnij się, że Performance Monitoringpakiet SDK jest prawidłowo zainicjowany w Twojej aplikacji.
Upewnij się, że pakiet SDK Performance Monitoringnie jest wyłączony za pomocą tej flagi:
performance.instrumentationEnabled
Upewnij się, że buforowanie w przeglądarce jest wyłączone. W przeciwnym razie przeglądarka może nie uwzględnić nowych ustawień instrumentacji.
Zamknij, a następnie ponownie otwórz kartę strony. Sprawdź ponownie, czy logowanie działa.
Jeśli pakiet SDK został właśnie dodany do aplikacji, może być konieczne jej ponowne uruchomienie, aby zaczął działać.Performance Monitoring
Konsola informuje, że pakiet SDK został wykryty, ale nie wyświetla żadnych danych
Performance Monitoring przetwarza dane o zdarzeniach związanych ze skutecznoś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 dowiedzieć się, czy nie występuje znana awaria. Jeśli nie ma awarii, skontaktuj się z zespołem pomocy Firebase.
Rozwiązywanie ogólnych problemów
Jeśli pakiet SDK został dodany i w aplikacji używasz Performance Monitoring, poniższe wskazówki dotyczące rozwiązywania problemów mogą pomóc w przypadku ogólnych problemów związanych z funkcjami i narzędziami Performance Monitoring.
Aplikacja nie rejestruje zdarzeń związanych z wydajnością
Pamiętaj, że Performance Monitoring rejestruje tylko dane opóźnienia pierwszego wejścia, gdy użytkownik kliknie stronę w ciągu 5 sekund od jej wczytania.
Sprawdź, czy aplikacja jest skonfigurowana do pomiaru tego wskaźnika. Dane dotyczące opóźnienia 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 dodanie tej biblioteki polyfill nie jest wymagane, aby Performance Monitoring zgłaszał inne dane aplikacji internetowej.
Na panelu skuteczności brakuje danych śledzenia niestandardowego
Czy widzisz dane o skuteczności automatycznie zbieranych logów czasu, ale nie widzisz ich w przypadku logów czasu z kodu niestandardowego? Wypróbuj te rozwiązania:
Sprawdź konfigurację śladów kodu niestandardowego instrumentowanych za pomocą interfejsu Trace API, a w szczególności:
Nazwy śladów kodu niestandardowego 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 ślady muszą być uruchomione i zatrzymane. Żadne ślady, które nie zostały rozpoczęte, nie zostały zatrzymane lub zostały zatrzymane przed rozpoczęciem, nie zostaną zarejestrowane.
Pamiętaj, że jeśli używasz metody
record()
nie musisz jawnie rozpoczynać ani zatrzymywać śledzenia.
W panelu wydajności brakuje danych żądania sieciowego
Jeśli brakuje Ci danych o żądaniach sieciowych, pamiętaj o tych kwestiach:
Performance Monitoring automatycznie zbiera dane o żądaniach sieciowych zgłaszanych przez interfejs API przeglądarki. Raporty te nie uwzględniają nieudanych żądań sieciowych.
W zależności od działania kodu i bibliotek sieciowych używanych przez Twój kod usługa Performance Monitoring może raportować tylko ukończone żądania sieciowe.
Oznacza to, że otwarte połączenia HTTP/S mogą nie być zgłaszane.
Dane żądań sieciowych nie są agregowane zgodnie z oczekiwaniami
Co się stało z sekcją Najważniejsze problemy na karcie Wydajność na stronie głównej projektu?
Zastąpiliśmy sekcję Najważniejsze problemy sekcją Ostatnie alerty. Jest to kontynuacja wprowadzenia przez nas 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 wpisy alertów w sekcji Ostatnie alerty. Wyświetlane są tylko 3 najnowsze alerty dotyczące wybranych aplikacji.
Co się stało z możliwością ustawiania progów dla problemów w konsoli?
Performance Monitoring obsługuje alerty dotyczące danych, które przekraczają zdefiniowane progi. Aby uniknąć nieporozumień związanych z tymi konfigurowalnymi progami dla danych o skuteczności, usunęliśmy możliwość konfigurowania progów dla problemów.
Co się stało z informacjami w sekcjach Szczegóły i Dane w konsoli Firebase?
Zastąpiliśmy strony Szczegóły i Dane nowo zaprojektowanym, scentralizowanym interfejsem, aby ułatwić rozwiązywanie problemów. Ten nowy interfejs rozwiązywania problemów oferuje te same podstawowe funkcje co sekcje Szczegóły i Dane. Więcej informacji o rozwiązywaniu problemów znajdziesz w sekcji Wyświetlanie większej ilości danych dotyczących konkretnego śledzenia.
Dlaczego liczba próbek nie jest zgodna z moimi oczekiwaniami?
Performance Monitoring zbiera dane dotyczące wydajności z urządzeń użytkowników Twojej aplikacji. Jeśli Twoja aplikacja ma wielu użytkowników lub generuje dużą liczbę zdarzeń związanych z wydajnością, Performance Monitoring może ograniczyć zbieranie danych do podzbioru urządzeń, aby zmniejszyć liczbę przetwarzanych zdarzeń. Limity te są na tyle wysokie, że nawet przy mniejszej liczbie zdarzeń wartości metryk nadal odzwierciedlają doświadczenia użytkownika korzystającego z aplikacji.
Aby zarządzać ilością zbieranych danych, Performance Monitoring korzysta z tych opcji próbkowania:
Ograniczanie szybkości na urządzeniu: aby zapobiec wysyłaniu przez urządzenie nagłych serii śladów, ograniczamy liczbę śladów kodu i żądań sieciowych wysyłanych z urządzenia do 300 zdarzeń co 10 minut. Takie podejście chroni urządzenie przed zapętlonymi instrumentacjami, które mogą wysyłać duże ilości danych o wydajności, i zapobiega zniekształcaniu pomiarów wydajności przez jedno urządzenie.
Próbkowanie dynamiczne:Performance Monitoring codziennie zbiera ograniczoną liczbę śladów kodu i śladów żądań sieciowych dla każdej aplikacji od wszystkich użytkowników aplikacji. Na urządzeniach pobierana jest dynamiczna częstotliwość próbkowania (za pomocą Firebase Remote Config), aby określić, czy losowe urządzenie ma przechwytywać i wysyłać ślady. Urządzenie, które nie zostało wybrane do próbkowania, nie wysyła żadnych zdarzeń. Dynamiczna częstotliwość próbkowania jest zależna od aplikacji i dostosowuje się tak, aby zapewnić, że całkowita objętość zebranych danych pozostanie poniżej limitu.
Sesje użytkownika wysyłają dodatkowe, szczegółowe dane z urządzenia użytkownika, co wymaga większych zasobów do przechwytywania i wysyłania danych. Aby zminimalizować wpływ sesji użytkowników, Performance Monitoring może również ograniczyć liczbę sesji.
Ograniczanie szybkości po stronie serwera: Aby mieć pewność, że aplikacje nie przekroczą limitu próbkowania, Performance Monitoring może używać próbkowania po stronie serwera w celu pomijania niektórych zdarzeń odbieranych z urządzeń. Chociaż tego typu ograniczenia nie zmieniają skuteczności naszych wskaźników, mogą powodować drobne zmiany wzorców, w tym:
Liczba śladów może różnić się od liczby wykonań fragmentu kodu.
Ślady, które są ściśle powiązane w kodzie, mogą mieć różną liczbę próbek.
Co się stało z kartą Problemy w konsoli?
Zastąpiliśmy kartę Problemy wprowadzeniem alertów, które automatycznie powiadamiają Cię o przekroczeniu ustawionych przez Ciebie progów. Nie musisz już ręcznie sprawdzać Firebase konsoli, aby określić stan progu. Aby dowiedzieć się więcej o alertach, zobacz Konfigurowanie alertów dotyczących problemów z wydajnością.
Co się stało z kartami Na urządzeniu i Sieć w konsoli?
Jak mogę wyświetlić ślady na tych stronach?
Przeprojektowaliśmy sekcję Performance Monitoring w Firebase konsoli, aby na karcie Panel wyświetlać kluczowe dane i wszystkie logi czasu w jednym miejscu. W ramach zmian w projekcie usunęliśmy strony Na urządzeniu i Sieć.
Tabela śladów u dołu karty Panel zawiera wszystkie informacje wyświetlane na kartach Na urządzeniu i Sieć, ale z dodatkowymi funkcjami, w tym możliwością sortowania śladów według procentowej zmiany określonych danych. Aby wyświetlić wszystkie metryki i dane dla konkretnego śladu, kliknij nazwę śladu w tabeli śladów.
Ślady możesz wyświetlić w tych podkartach tabeli śladów:
Logi czasu żądań sieciowych (gotowe i niestandardowe) – karta Żądania sieciowe
Niestandardowe ślady kodu — podkarta Niestandardowe ślady
Logi czasu uruchomienia aplikacji, działania aplikacji na pierwszym planie i działania aplikacji w tle – karta Niestandardowe logi czasu
Logi czasu renderowania ekranu – karta Renderowanie ekranu
Ślady ładowania strony — podkarta Ładowanie strony
Aby uzyskać szczegółowe informacje na temat tabeli śladów oraz wyświetlania metryk i danych, odwiedź stronę przeglądu konsoli (iOS+ | Android | Internet).
Dlaczego liczba wolno wyrenderowanych i zamrożonych klatek nie jest taka, jakiej się spodziewam?
Powolne renderowanie klatek i klatki zamrożone są obliczane przy założeniu częstotliwości odświeżania urządzenia wynoszącej 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ż na sekundę renderowanych jest mniej klatek.
Wolniejsze czasy renderowania mogą powodować zgłaszanie większej liczby wolniejszych lub zamrożonych klatek, ponieważ więcej klatek będzie renderowanych wolniej lub ulegnie zamrożeniu. Jeśli jednak częstotliwość odświeżania urządzenia jest wyższa niż 60 Hz, każda klatka będzie renderowana szybciej.
Może to spowodować zgłaszanie mniejszej liczby wolnych lub zamrożonych klatek. Jest to aktualne ograniczenie w pakiecie SDK Performance Monitoring.
Jak dodać mniejszy pakiet Performance Monitoring JS SDK z przestrzenią nazw („samodzielny” pakiet SDK) do mojej aplikacji internetowej?
Jeśli Performance Monitoring jest jedyną usługą Firebase w Twojej aplikacji, możesz użyć samodzielnego pakietu SDK Performance Monitoring (i zalecanego skryptu nagłówka poniżej), jeśli interesuje Cię:
używanie biblioteki z przestrzenią nazw,
zmniejszanie rozmiaru pakietu SDK
opóźnianie inicjalizacji zestawu SDK do momentu załadowania strony
Aby uwzględnić samodzielny pakiet SDK Performance Monitoring w aplikacji i opóźnić jego inicjalizację do momentu załadowania strony:
Powyższy skrypt asynchronicznie ładuje samodzielny zestaw SDK, a następnie inicjuje Firebase po wywołaniu zdarzenia onload okna. Taka taktyka zmniejsza wpływ, jaki zestaw SDK może mieć na wskaźniki ładowania strony, ponieważ przeglądarka zgłosiła już swoje wskaźniki ładowania w momencie inicjalizacji zestawu SDK.
Dowiedz się więcej o samodzielnym pakiecie SDK Performance Monitoring i skrypcie nagłówka
Ten samodzielny pakiet SDK jest zoptymalizowany pod kątem rozmiaru. Po skompresowaniu za pomocą gzipa ma około 10 KB. Zawiera wszystkie funkcjonalności Firebase Performance Monitoring, a także minimalny zestaw podstawowych funkcji pakietu Firebase SDK.
Firebase Performance Monitoring używa interfejsów API fetch i Promise, które nie są dostępne w starszych przeglądarkach. Polyfille dla tych interfejsów API są zawarte w standardowym pakiecie SDK JS Firebase Performance Monitoring, ale pominięto je w samodzielnym pakiecie SDK w celu zmniejszenia rozmiaru.
Pakiet SDK Performance Monitoring korzysta częściowo z interfejsu Resource Timing API, aby uzyskiwać z przeglądarki dane o czasie wczytywania strony.
Poniższy fragment kodu przedstawia skrypt nagłówka, który następnie opóźnia inicjalizację zestawu SDK:
(function(sdkSource,firebaseConfigObject){functionload(f,c){//CreatesascripttagtoloadthestandaloneSDKvarsdkScript=document.createElement('script');//Setsittoanasyncscriptsothatitdoesn't interfere with page loadsdkScript.async=1;//SetsthesourceofthescriptsdkScript.src=f;//Insertsthescriptintotheheadofthepagevars=document.getElementsByTagName('script')[0];s.parentNode.insertBefore(sdkScript,s);}//Callstheloadmethodload(sdkSource);//InitializestheSDKonlywhentheonloadmethodiscalledwindow.addEventListener('load',function(){firebase.initializeApp(firebaseConfigObject).performance();});})(performance_standalone,firebaseConfig);
Gdzie,
performance_standalone to 'https://www.gstatic.com/firebasejs/12.6.0/firebase-performance-standalone.js'
Przetwarzanie i wyświetlanie danych w czasie niemal rzeczywistym
Co oznaczają dane dotyczące wydajności „w czasie niemal rzeczywistym”?
Firebase Performance Monitoring przetwarza zebrane dane o skuteczności na bieżąco, co powoduje, że w konsoli Firebase są one wyświetlane niemal w czasie rzeczywistym. Przetworzone dane są wyświetlane w konsoli w ciągu kilku minut od ich zebrania, stąd określenie „niemal w czasie rzeczywistym”.
Jak uzyskać dane o skuteczności aplikacji w czasie zbliżonym do rzeczywistego?
Aby korzystać z przetwarzania danych w czasie zbliżonym do rzeczywistego, musisz tylko upewnić się, że Twoja aplikacja używa pakietu SDK w wersji Performance Monitoring, która jest zgodna z przetwarzaniem danych w czasie rzeczywistym.
Oto wersje pakietu SDK zgodne z czasem rzeczywistym:
iOS – wersja 7.3.0 lub nowsza
tvOS – wersja 8.9.0 lub nowsza
Android – wersja 19.0.10 lub nowsza (albo Firebase Android BoM wersja 26.1.0 lub nowsza)
Internet – wersja 7.14.0 lub nowsza
Zalecamy używanie najnowszej wersji pakietu SDK, ale każda z wersji wymienionych powyżej umożliwi Performance Monitoring przetwarzanie danych w czasie zbliżonym do rzeczywistego.
Które wersje pakietu Performance Monitoring SDK są zgodne z czasem rzeczywistym?
Oto wersje pakietu SDK 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 (albo Firebase Android BoM wersja 26.1.0 lub nowsza)
Internet – wersja 7.14.0 lub nowsza
Zalecamy używanie najnowszej wersji pakietu SDK, ale każda z wersji wymienionych powyżej umożliwi Performance Monitoring przetwarzanie danych w czasie zbliżonym do rzeczywistego.
Co się stanie, jeśli nie zaktualizuję aplikacji, aby korzystała z wersji pakietu SDK zgodnej z czasem rzeczywistym?
Jeśli Twoja aplikacja nie używa wersji pakietu SDK zgodnej z czasem rzeczywistym, w Firebasekonsoli nadal będziesz widzieć wszystkie dane o jej działaniu. Wyświetlanie danych o skuteczności będzie jednak opóźnione o około 36 godzin od momentu ich zebrania.
Mam już wersję pakietu SDK zgodną z czasem rzeczywistym, ale niektórzy użytkownicy nadal korzystają ze starszych wersji mojej aplikacji. Czy nadal będę widzieć dane o ich 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 (starsze niż ok. 36 godzin), wyświetlane dane pochodzą od użytkowników instancji aplikacji korzystających z wersji pakietu SDK zgodnej z czasem rzeczywistym. Starsze dane obejmują jednak dane o skuteczności ze wszystkich wersji aplikacji.