Rozwiązywanie problemów z monitorowaniem wydajności i często zadawane pytania

iOS + Android Web

Ta strona zawiera wskazówki dotyczące rozwiązywania problemów, które ułatwiają rozpoczęcie pracy z monitorowaniem wydajności lub korzystaniem z funkcji i narzędzi monitorowania wydajności.

Pierwsze kontrole pod kątem rozwiązywania problemów

Poniższe dwie kontrole są ogólnymi najlepszymi praktykami zalecanymi każdemu przed dalszym rozwiązywaniem problemów.

1. Sprawdź komunikaty dziennika pod kątem zdarzeń dotyczących wydajności

Sprawdź komunikaty dziennika, aby upewnić się, że zestaw SDK monitorowania wydajności przechwytuje zdarzenia dotyczące wydajności.

Jak wyświetlić komunikaty dziennika dotyczące zdarzeń wydajności?

1. Otwórz narzędzia dla programistów w przeglądarce (na przykład, zakładka dla Chrome Dev Narzędzia sieciowe lub w Monitorze sieci dla Firefoksa ).

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

3. Sprawdź komunikaty dziennika pod kątem komunikatów o błędach.

4. Po kilku sekundach, szukać połączenia sieciowego firebaselogging.googleapis.com w dostarczaniu narzędzi programistycznych w Twojej przeglądarce. Obecność tego połączenia sieciowego wskazuje, że przeglądarka wysyła dane o wydajności do Firebase.

Jeśli aplikacja nie jest rejestrowanie zdarzeń z wydajnością, przejrzeć wskazówki dotyczące rozwiązywania problemów .

2. Sprawdź panel stanu Firebase

Sprawdź panel stanu Firebase w przypadku Znany jest przerwa na Firebase lub do monitorowania wydajności.

Pierwsze kroki z monitorowaniem wydajności

Jeśli zaczynasz z Monitorowanie wydajności ( iOS + | Android | Web ), następujące wskazówki dotyczące rozwiązywania problemów mogą pomóc w kwestiach, które dotyczą Firebase wykrywania SDK lub wyświetlając swoje pierwsze dane dotyczące wydajności w konsoli Firebase.

Dodano SDK do aplikacji, ale konsola nadal mówi, aby dodać SDK

Firebase może wykryć, czy pomyślnie dodałeś pakiet SDK monitorowania wydajności do swojej aplikacji, gdy otrzyma z niej informacje o zdarzeniach (takich jak interakcje w aplikacji). Zwykle w ciągu 10 minut od rozpoczęcia aplikacji, deska rozdzielcza wydajności konsoli wyświetlaczy Firebase „SDK wykryte” wiadomość. Następnie w ciągu 30 minut na desce rozdzielczej wyświetlane są wstępnie przetworzone dane.

Jeśli minęło więcej niż 10 minut od momentu dodania najnowszą wersję pakietu SDK do aplikacji, a nie jesteś jeszcze widząc żadnej zmiany, sprawdzać wiadomości dziennika , aby upewnić się, że monitorowanie wydajności jest rejestrowanie zdarzeń. Wypróbuj odpowiednie kroki rozwiązywania problemów opisane poniżej, aby rozwiązać problem z komunikatem o wykryciu opóźnionego pakietu SDK.

Aplikacja rejestruje zdarzenia: kroki rozwiązywania problemów

Uwaga: Performance Monitoring SDK partiach zdarzenia lokalnie, a następnie wysyła je do Firebase okresowo. Oznacza to, że między interakcją w aplikacji a otrzymaniem przez Firebase informacji o zdarzeniu z Twojej aplikacji występuje opóźnienie.

1. Jeśli nadal rozwijasz się lokalnie, spróbuj wygenerować więcej zdarzeń do zbierania danych:

   1. Udostępniaj i wyświetlaj swoją aplikację internetową w środowisku lokalnym.

   2. Generuj zdarzenia, ładując podstrony Twojej witryny, wchodząc w interakcję z Twoją aplikacją i/lub wywołując żądania sieciowe. Upewnij się, że karta przeglądarki jest otwarta przez co najmniej 10 sekund po załadowaniu strony.

2. Upewnij się, że Firebase obiekt konfiguracja jest poprawnie dodany do aplikacji, a które nie zostały zmodyfikowane obiekt. W szczególności sprawdź następujące elementy:

   • Firebase Web App ID ( appId ) w obiekcie konfiguracyjnym jest właściwy dla danej aplikacji. Znajdź swój Firebase identyfikator aplikacji na karcie aplikacje swoich ustawieniach projektu .

   Jeśli coś wydaje się nie tak z obiektem konfiguracyjnym w Twojej aplikacji, spróbuj wykonać następujące czynności:

   1. Usuń obiekt konfiguracyjny, który aktualnie masz w swojej aplikacji.

   2. Postępuj zgodnie z poniższymi instrukcjami , aby otrzymać nowy obiekt config i dodać go do swojej aplikacji internetowej.

3. Jeśli SDK jest rejestrowanie zdarzeń i wszystko wydaje się być ustawione poprawnie, ale nie masz jeszcze widząc komunikat wykrywania SDK lub przetwarzanych danych (po 2 godziny), kontakt Firebase Pomoc .

Aplikacja nie jest rejestrowanie zdarzeń: rozwiązywanie problemów kroki

1. Upewnij się, że wydajność Monitorowanie SDK jest prawidłowo zainicjowany w swojej aplikacji.

2. Upewnij się, że wydajność Monitorowanie SDK nie jest wyłączone przez następujące flagi:

   • performance.instrumentationEnabled

3. Upewnij się, że Twoja przeglądarka buforowanie jest wyłączone, w przeciwnym razie przeglądarka może nie odebrać nowe ustawienia sprzętu.

4. Zamknij, a następnie ponownie otwórz kartę strony internetowej. Sprawdź ponownie logowanie.

   Jeśli właśnie dodałeś zestaw SDK monitorowania wydajności do swojej aplikacji, może być konieczne całkowite ponowne uruchomienie aplikacji, aby zestaw SDK zaczął działać.

5. Jeśli nie można znaleźć niczego, co jest wyłączony w Twojej aplikacji, kontaktów Firebase Wsparcia .

Konsola mówi, że SDK został wykryty, ale żadne dane nie są wyświetlane

Monitorowanie wydajności przetwarza dane o zdarzeniach z wydajnością przed wyświetleniem go w desce rozdzielczej wydajności .

Jeśli minęło więcej niż 24 godzin od pojawienia się komunikatu „Wykryto SDK”, a nie jesteś jeszcze zobaczyć dane, a następnie sprawdzić panel stanu Firebase w przypadku Znany jest przerwa. Jeśli nie ma przerwy, kontakt Firebase Pomoc .

Ogólne rozwiązywanie problemów

Jeśli pomyślnie dodałeś zestaw SDK i używasz monitorowania wydajności w swojej aplikacji, poniższe wskazówki dotyczące rozwiązywania problemów mogą pomóc w ogólnych problemach związanych z funkcjami i narzędziami monitorowania wydajności.

Aplikacja nie rejestruje zdarzeń dotyczących wydajności

Jeśli nie widzisz wiadomości dziennika zdarzeń wydajności , spróbuj wykonać następujące kroki w celu rozwiązania problemu:

1. Upewnij się, że wydajność Monitorowanie SDK jest prawidłowo zainicjowany w swojej aplikacji.

2. Upewnij się, że wydajność Monitorowanie SDK nie jest wyłączone przez następujące flagi:

   • performance.instrumentationEnabled

3. Upewnij się, że Twoja przeglądarka buforowanie jest wyłączone, w przeciwnym razie przeglądarka może nie odebrać nowe ustawienia sprzętu.

4. Zamknij, a następnie ponownie otwórz kartę strony internetowej. Sprawdź ponownie logowanie.

   Jeśli właśnie dodałeś zestaw SDK monitorowania wydajności do swojej aplikacji, może być konieczne całkowite ponowne uruchomienie aplikacji, aby zestaw SDK zaczął działać.

5. Jeśli nie można znaleźć niczego, co jest wyłączony w Twojej aplikacji, kontaktów Firebase Wsparcia .

W panelu wydajności brakuje danych o opóźnieniu pierwszego wejścia

Jeśli nie widzisz danych do pierwszego opóźnienia metryczne , spróbuj wykonać następujące kroki w celu rozwiązania problemu:

1. Należy pamiętać, że wydajność Monitorowanie tylko nagrywa pierwsze opóźnienie metryczne, gdy użytkownik kliknie na stronie internetowej w ciągu pierwszych 5 sekund po załadowaniu strony.

2. Upewnij się, że masz skonfigurowaną aplikację do mierzenia tych danych. Opóźnienie pierwszy metryczne wymaga ręcznej konfiguracji . W szczególności musisz dodać bibliotekę wypełniaczy dla tej metryki. Instrukcje instalacji znajdują się biblioteki dokumentacji .

   Należy zauważyć, że dodanie tej biblioteki wypełnienia nie jest wymagane, aby monitorowanie wydajności raportowało inne metryki aplikacji sieci Web.

W panelu wydajności brakuje niestandardowych danych śledzenia

Widzisz dane dotyczące skuteczności automatycznie zebranych śladów, ale nie dla własnych śladów kodu? Wypróbuj następujące kroki rozwiązywania problemów:

1. Sprawdź konfigurację własnych śladów kodu oprzyrządowanych poprzez śledzenia API , zwłaszcza, że:

   • Nazwy śladów niestandardowy kod i niestandardowych danych musi spełniać następujące wymagania: nie prowadzące lub końcowe białe znaki, nie prowadząc podkreślenia ( _ znaków), a maksymalna długość to 32 znaków.
   • Wszystkie ślady muszą być uruchamiane i zatrzymywane. Żadne śledzenie, które nie zostało uruchomione, nie zatrzymane lub zatrzymane przed uruchomieniem, nie zostanie zarejestrowane.

   Zauważ, że jeśli używasz record() metodę, wtedy nie trzeba jawnie uruchomić lub zatrzymać swój ślad.

2. Upewnij się, że wydajność kolekcja Monitorowanie danych nie jest wyłączone przez następujące flagi:

   • performance.dataCollectionEnabled

     Ta flaga steruje zbieraniem danych tylko dla niestandardowych śladów kodu (nie wszystkich danych).

3. Sprawdź swoje wiadomości dziennika , aby upewnić się, że monitorowanie wydajności jest zalogowaniu oczekiwanych śladów kodu niestandardowego.

4. Jeśli Monitorowanie wydajności jest rejestrowanie zdarzeń, ale nie wyświetla danych po upływie 24 godzin, kontakt Firebase Pomoc .

W panelu wydajności brakuje danych żądania sieciowego

Jeśli brakuje danych żądania sieciowego, pamiętaj o następujących kwestiach:

• Performance Monitoring automatycznie zbiera metryki dla żądań sieciowych zgłaszanych przez API przeglądarki. Raporty te nie obejmują nieudanych żądań sieciowych.

• W zależności od zachowania kodu i bibliotek sieciowych używanych przez kod, monitorowanie wydajności może zgłaszać tylko żądania sieciowe, które zostały zakończone. Oznacza to, że pozostawione otwarte połączenia HTTP/S mogą nie być zgłaszane.

Dane żądań sieciowych nie są agregowane zgodnie z oczekiwaniami

Więcej informacji na temat sposobu monitorowania wydajności agregatów sieć danych żądania pod wzorców adresów URL.

Można również wypróbować niestandardowe wzory URL !

FAQ

iOS + Android Web

Co stało się z urządzeniem na kartach i sieci w konsoli? Jak wyświetlić ślady, które znajdowały się na tych stronach?

Mamy przeprojektowany sekcję Monitorowanie wydajności konsoli Firebase tak, że zakładka wyświetla Kokpit swój klucz metryki i wszystkie ślady w jednej przestrzeni. W ramach przebudowy usunęliśmy urządzenia, na i stron sieciowych.

Tabela ślady na dnie karcie Panel posiada wszystkie te same informacje, że na urządzeniu oraz kartach sieciowych wyświetlany, ale z pewnych dodatkowych funkcji, w tym możliwość sortowania swoich śladów o procentową zmianę zadaniu metrycznym. Aby wyświetlić wszystkie dane i dane dla konkretnego śladu, kliknij nazwę śledzenia w tabeli śladów.

Wyświetl swoje ślady w następujących podkartach tabeli śladów:

• Ślady żądanie sieciowe (zarówno out-of-the-box i zwyczaju) - sieć żąda podkartę
• Niestandardowy kod ślady - ślady niestandardowe podkarty
• Aplikacja start, app-w-planie, app-w-tle śladów - ślady niestandardowe podkartę
• Ślady wykończeniowych ekranu - ekran renderowania podkarta
• Strona obciążenia ślady - Strona obciążenie podkarty

Szczegółowe informacje na temat tabeli ślady i przeglądanie danych i danych, odwiedź stronę wprowadzenia konsoli ( iOS + | Android | WWW ).

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

Monitorowanie wydajności wsporniki powiadomienia dla metryki, które przekraczają określone progi. Aby uniknąć pomyłek z tych progów konfigurowalnych wskaźników wydajności usunęliśmy zdolność do progów Konfiguracja dla zagadnień .

Jak dodać mniejszy zestaw SDK do monitorowania wydajności w przestrzeni nazw („autonomiczny” zestaw SDK) do mojej aplikacji sieci Web?

Jeśli Performance Monitoring jest jedynym produktem Firebase w Twojej aplikacji, możesz użyć samodzielnego pakietu SDK Performance Monitoring (i zalecanego skryptu nagłówka poniżej), jeśli jesteś zainteresowany:

• przy użyciu biblioteki z przestrzenią nazw
• zmniejszenie rozmiaru pakietu SDK
• opóźnianie inicjalizacji SDK do czasu załadowania strony

Ważne: W przypadku większości Firebase aplikacji internetowych, zalecamy pomocą Firebase JS SDK w wersji 9 poprzez npm .
Również, korzystając z modułu NPM Bundler , można osiągnąć nawet mniejszy rozmiar pakietu SDK niż przy użyciu autonomicznego monitorowania wydajności SDK.

Aby dołączyć samodzielny pakiet SDK do monitorowania wydajności w swojej aplikacji i opóźnić jego inicjowanie do momentu załadowania strony:

1. Dodaj następujący skrypt do nagłówka pliku indeksu.
2. Upewnij się, aby dodać swojej aplikacji Firebase obiektu konfiguracji projektu .

(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 jest 'https://www.gstatic.com/firebasejs/9.6.3/firebase-performance-standalone.js'
• firebaseConfig jest z aplikacji Firebase config przedmiot

Powyższy skrypt asynchronicznie wczytuje SDK samodzielny następnie inicjuje Firebase po okna onload pożary zdarzeń. Taktyka ta zmniejsza wpływ, jaki może mieć na SDK metryk strona załadowała ponieważ przeglądarka ma już zgłoszone do jego ładowania metryki kiedy zainicjować SDK.

Uwaga: W przypadku korzystania z autonomicznego monitorowania wydajności SDK, jawnie nie zawierają rdzeń SDK Firebase, jako samodzielny pakiet SDK zawiera już własną lżejszego Firebase rdzenia SDK.

Dowiedz się więcej o samodzielnym pakiecie SDK do monitorowania wydajności i skrypcie nagłówka

Ten samodzielny pakiet SDK jest zoptymalizowany pod kątem rozmiaru; Spakowany gzipem, ma około 10kb. Posiada wszystkie funkcje Firebase Performance Monitoring wraz z minimalnym zestawem podstawowych funkcji Firebase SDK.

Firebase wydajności zastosowań monitoringu fetch i Promise API, które nie są dostępne w starszych przeglądarkach. Wypełnienia dla tych interfejsów API są zawarte w standardowym pakiecie SDK Firebase Performance Monitoring JS, ale są pomijane w samodzielnym pakiecie SDK, aby zmniejszyć rozmiar.

Performance Monitoring SDK opiera się po części na Timing API zasobów w celu uzyskania metryki ładowania strony w przeglądarce.

Poniższy fragment przedstawia opis skryptu nagłówka, który zawiera opóźnienie inicjalizacji 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);

gdzie,

• performance_standalone jest 'https://www.gstatic.com/firebasejs/9.6.3/firebase-performance-standalone.js'
• firebaseConfig jest z aplikacji Firebase config przedmiot

Przetwarzanie i wyświetlanie danych w czasie zbliżonym do rzeczywistego

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

Firebase Performance Monitoring przetwarza zebrane dane o wydajności w miarę ich pojawiania się, co skutkuje wyświetlaniem danych w czasie zbliżonym do rzeczywistego w konsoli Firebase. Przetworzone dane wyświetlają się w konsoli w ciągu kilku minut od ich zebrania, stąd określenie „czas prawie rzeczywisty”.

Aby skorzystać z przetwarzania danych niemal w czasie rzeczywistym, upewnij się, że aplikacja używa w czasie rzeczywistym wersja kompatybilna SDK .

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

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

Oto wersje SDK kompatybilne w czasie rzeczywistym:

• iOS - v7.3.0 lub później
• tvOS - v8.9.0 lub później
• Android - v19.0.10 lub później (lub Firebase Android BoM v26.1.0 lub nowszy)
• Web - v7.14.0 lub później

Pamiętaj, że zawsze zalecamy korzystanie z najnowszej wersji SDK, ale każda wersja wymieniona powyżej umożliwi Monitorowaniu wydajności przetwarzanie danych w czasie zbliżonym do rzeczywistego.

Które wersje zestawu SDK monitorowania wydajności są uważane za zgodne w czasie rzeczywistym?

Oto wersje SDK kompatybilne z przetwarzaniem danych w czasie rzeczywistym:

• iOS - v7.3.0 lub później
• tvOS - v8.9.0 lub później
• Android - v19.0.10 lub później (lub Firebase Android BoM v26.1.0 lub nowszy)
• Web - v7.14.0 lub później

Pamiętaj, że zawsze zalecamy korzystanie z najnowszej wersji SDK, ale każda wersja wymieniona powyżej umożliwi Monitorowaniu wydajności przetwarzanie danych w czasie zbliżonym do rzeczywistego.

Co się stanie, jeśli nie zaktualizuję swojej aplikacji, aby korzystała z wersji SDK zgodnej w czasie rzeczywistym?

Jeśli Twoja aplikacja nie korzysta z wersji SDK zgodnej w czasie rzeczywistym, nadal będziesz widzieć wszystkie dane o wydajności aplikacji w konsoli Firebase. Jednak wyświetlanie danych o wydajności zostanie opóźnione o około 36 godzin od momentu ich zebrania.

Zaktualizowałem pakiet SDK do wersji zgodnej w czasie rzeczywistym, ale niektórzy z moich użytkowników nadal korzystają ze starych wersji mojej aplikacji. Czy nadal widzę ich dane o wydajności w konsoli Firebase?

Tak! Niezależnie od wersji pakietu SDK używanej przez instancję aplikacji zobaczysz dane o wydajności od wszystkich użytkowników.

Jednakże, jeśli szukasz na ostatnich danych (mniej niż około 36 godzin życia), a następnie wyświetlany jest dane od użytkowników instancji aplikacji w czasie rzeczywistym z wykorzystaniem wersji zgodny SDK. Nie-ostatnie dane, choć zawiera dane dotyczące wydajności z wszystkimi wersjami aplikacji.

Kontakt z pomocą techniczną Firebase

Jeśli sięgnąć do Firebase obsługa , zawsze zawierać Firebase App ID. Znajdź swój Firebase identyfikator aplikacji na karcie aplikacje swoich ustawieniach projektu .