Rozwiązywanie problemów z monitorowaniem wydajności i najczęstsze pytania
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ą
Włącz logowanie debugowania w ten sposób:
W Xcode (minimum w wersji 16.2) kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat).
W menu po lewej stronie kliknij Run (Uruchom), a następnie wybierz kartę Arguments (Argumenty).
W sekcji Arguments Passed on Launch (Argumenty przekazywane przy uruchamianiu) dodaj -FIRDebugEnabled.
Sprawdź, czy w komunikatach dziennika nie ma żadnych błędów.
Performance Monitoring oznacza swoje komunikaty logu tagiem Firebase/Performance, dzięki czemu możesz je filtrować.
Sprawdź, czy występują te typy dzienników, które wskazują, że Performance Monitoring rejestruje zdarzenia związane z wydajnością:
Otwórz Panel stanu Firebase, aby sprawdzić, czy występuje przerwa w dostępie do Firebase lub Performance Monitoring.
Pierwsze kroki w Performance Monitoring
Jeśli dopiero zaczynasz korzystać z Performance Monitoring(iOS+ | Android | Web), poniższe wskazówki dotyczące rozwiązywania problemów mogą Ci pomóc w przypadku problemów związanych z wykrywaniem pakietu SDK przez Firebase lub wyświetlaniem pierwszych danych o 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 pakiet SDK został dodany do aplikacji, gdy otrzyma z niej informacje o zdarzeniach (np. interakcjach z aplikacją). Zwykle w ciągu 10 minut od uruchomienia aplikacji na paneluFirebasekonsoli wyświetla się komunikat „Wykryto pakiet SDK”.Performance Monitoring W ciągu 30 minut w panelu wyświetlą się wstępnie przetworzone dane.
Jeśli od dodania najnowszej wersji pakietu SDK do aplikacji minęło więcej niż 10 minut, a nadal nie widzisz żadnych zmian, sprawdź komunikaty w dzienniku, 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: czynności związane z rozwiązywaniem problemów
Jeśli nadal pracujesz lokalnie, spróbuj wygenerować więcej zdarzeń na potrzeby zbierania danych:
Kontynuuj tworzenie aplikacji za pomocą symulatora lub urządzenia testowego.
Wygeneruj zdarzenia, przełączając aplikację między tłem a pierwszym planem kilka razy, wchodząc z nią w interakcję przez poruszanie się po ekranach lub wywołując żądania sieciowe.
Sprawdź, czy plik konfiguracji Firebase (Google-Service-Info.plist) został prawidłowo dodany do aplikacji i czy nie został zmodyfikowany.
Sprawdź te kwestie:
Nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, np. (2).
Plik konfiguracji znajduje się w katalogu głównym projektu Xcode i jest dodany do odpowiednich elementów docelowych.
Identyfikator aplikacji Firebase na iOS (GOOGLE_APP_ID) podany w pliku konfiguracyjnym jest prawidłowy w przypadku Twojej aplikacji. Znajdź identyfikator aplikacji Firebase na karcie Twoje aplikacje w settingsustawieniach projektu.
Jeśli w pliku konfiguracyjnym aplikacji coś jest nie tak, wykonaj te czynności:
Usuń plik konfiguracyjny, który masz obecnie w aplikacji.
Aby pobrać nowy plik konfiguracyjny i dodać go do aplikacji na urządzenia Apple, wykonaj te instrukcje.
Jeśli pakiet SDK rejestruje zdarzenia i wszystko wydaje się być prawidłowo skonfigurowane, ale nadal nie widzisz komunikatu o wykryciu pakietu SDK ani przetworzonych danych (po 2 godzinach), skontaktuj się z zespołem pomocy Firebase.
Aplikacja nie rejestruje zdarzeń: kroki rozwiązywania problemów
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 używasz w aplikacji funkcji 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ą
Jeśli brakuje Ci danych dotyczących śladów renderowania ekranu, wykonaj te czynności:
Upewnij się, że używasz najnowszej wersji pakietu SDK na platformy Apple (11.15.0). Ślady renderowania ekranu są dostępne tylko w przypadku wersji 5.0.0 lub nowszej.
Performance Monitoring nie tworzy śladów renderowania ekranu w przypadku kontrolerów widoku kontenera (takich jak UINavigationController i UITabBarController). Jeśli brakuje danych tylko w przypadku tych ekranów, jest to oczekiwane zachowanie.
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.
Sprawdź wiadomości w logach, aby upewnić się, że Performance Monitoring rejestruje oczekiwane ślady kodu niestandardowego.
W zależności od działania kodu i bibliotek sieciowych używanych przez Twój kod Performance Monitoring może raportować tylko ukończone żądania sieciowe. Oznacza to, że otwarte połączenia HTTP/S mogą nie być zgłaszane.
Performance Monitoring nie raportuje żądań sieciowych z nieprawidłowymiContent-Type nagłówkami. Żądania sieciowe bez nagłówków Content-Type będą jednak nadal akceptowane.
Dane żądań sieciowych nie są agregowane zgodnie z oczekiwaniami
Co się stało z sekcją Najważniejsze problemy na karcie Skuteczność na stronie głównej projektu?
Zastąpiliśmy sekcję Najważniejsze problemy sekcją Ostatnie alerty. Jest to kontynuacja niedawnego wprowadzenia 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ć Ci 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 o skuteczności z urządzeń użytkowników Twojej aplikacji. Jeśli Twoja aplikacja ma wielu użytkowników lub generuje dużą liczbę danych o wydajności, 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żytkowników związane z aplikacją.
Aby zarządzać ilością zbieranych danych, Performance Monitoring korzysta z tych opcji próbkowania:
Ograniczanie liczby żądań na urządzeniu: aby zapobiec wysyłaniu przez urządzenie nagłych serii śladów, ograniczamy liczbę śladów kodu i żądania sieciowe wysyłane 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 w przypadku 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 specyficzna dla aplikacji i dostosowuje się tak, aby ogólna ilość zebranych danych nie przekraczała limitu.
Projekty, w których włączono integrację z BigQuery, mają wyższy limit liczby śladów żądań sieciowych.
Sesje użytkowników wysyłają dodatkowe, szczegółowe dane z urządzenia użytkownika, co wymaga większych zasobów do rejestrowania i przesyłania danych. Aby zminimalizować wpływ sesji użytkowników, Performance Monitoring może też ograniczyć liczbę sesji.
Ograniczanie liczby żądań po stronie serwera: aby mieć pewność, że aplikacje nie przekraczają limitu próbkowania, Performance Monitoring może stosować próbkowanie po stronie serwera, aby odrzucać niektóre zdarzenia otrzymywane z urządzeń. Chociaż ten rodzaj ograniczenia nie zmienia skuteczności naszych danych, może powodować niewielkie zmiany wzorców, w tym:
Liczba śladów może się różnić od liczby uruchomień 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. Więcej informacji o alertach znajdziesz w artykule Konfigurowanie alertów dotyczących problemów z wydajnością.
Co się stało z kartami Na urządzeniu i Sieć w konsoli?
Jak wyświetlić ślady, które znajdowały się 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 zmiany wyglądu 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 dane i rodzaje danych dotyczące konkretnego śladu, kliknij jego nazwę 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
Logi czasu własnego kodu – karta Logi czasu niestandardowego
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
Logi czasu wczytania strony – karta Wczytanie strony
Szczegółowe informacje o tabeli śladów oraz wyświetlaniu danych i statystyk znajdziesz na stronie przeglądu konsoli (iOS | Android | Internet).
Dlaczego liczba wolno wyrenderowanych i zamrożonych klatek nie jest taka, jakiej się spodziewam?
Spowolnione i zablokowane klatki są obliczane przy założeniu, że częstotliwość odświeżania urządzenia wynosi 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.
Dłuższy czas renderowania może powodować zgłaszanie większej liczby spowolnionych lub zamrożonych klatek, ponieważ więcej klatek będzie renderowanych wolniej lub będzie zamrożonych. 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 powolnych lub zamrożonych klatek. Jest to obecne ograniczenie pakietu Performance Monitoring SDK.
Eksportowanie danych z Performance Monitoring do BigQuery trwa dłużej niż oczekiwano. Czy nie jest to czas rzeczywisty?
Jeśli masz włączoną integrację BigQuery z Firebase Performance Monitoring, dane będą eksportowane do BigQuery w ciągu 12–24 godzin od zakończenia dnia (czasu pacyficznego).
Na przykład dane z 19 kwietnia będą dostępne w BigQuery 20 kwietnia między południem a północą (wszystkie daty i godziny są podane według czasu pacyficznego).
Przetwarzanie i wyświetlanie danych w czasie zbliżonym do rzeczywistego
Co oznaczają dane o skuteczności „niemal w czasie 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 zadbać o to, aby Twoja aplikacja używała pakietu SDK w wersji Performance Monitoring, która jest zgodna z przetwarzaniem danych w czasie rzeczywistym.
Są to 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 działaniem w czasie 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 o mniej więcej 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.
