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ą
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ź komunikaty dziennika pod kątem ewentualnych komunikatów o błędach.
Performance Monitoring oznacza swoje komunikaty dziennika tagiem Firebase/Performance, dzięki czemu możesz filtrować komunikaty dziennika.
Sprawdź, czy występują te typy dzienników, które wskazują, że usługa Performance Monitoring rejestruje zdarzenia związane z wydajnością:
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 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.
Upewnij się, że plik konfiguracji Firebase (Google-Service-Info.plist) został prawidłowo dodany do aplikacji i że 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 urządzenia Apple (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 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ą
Jeśli brakuje Ci danych dotyczących śladów renderowania ekranu, wykonaj te czynności:
Sprawdź, czy używasz najnowszej wersji pakietu SDK na platformy Apple (12.6.0). Ślady renderowania ekranu są dostępne tylko w przypadku wersji 5.0.0 lub nowszych.
Performance Monitoring nie tworzy śladów renderowania ekranu w przypadku kontrolerów widoku kontenera (takich jak UINavigationController i UITabBarController). Jeśli dane są niedostępne 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. Żaden ślad, który nie został rozpoczęty, niezatrzymany lub zatrzymany przed rozpoczęciem, nie zostanie zarejestrowany.
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 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.
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 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.
Projekty, w których włączono integrację z BigQuery, mają wyższy limit liczby śladów żądań sieciowych.
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.
Eksport moich danych z Performance Monitoring do BigQuery trwa dłużej niż oczekiwano. Czy to nie dzieje się w czasie rzeczywistym?
Jeśli włączono integrację BigQuery dla Firebase Performance Monitoring, dane zostaną wyeksportowane 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 godziną 12:00 a północą (wszystkie daty i godziny podano w strefie czasowej Pacyfiku).
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.
