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. Włącz logowanie debugowania w następujący sposób:

   1. W Xcode (minimalna wersja 14.1) wybierz Product > Schemat > Edytuj schemat.
   2. W menu po lewej stronie kliknij Uruchom i wybierz kartę Argumenty.
   3. W sekcji Arguments Passed at Launch (Argumenty przekazane przy uruchomieniu) dodaj parametr -FIRDebugEnabled.

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

3. Monitorowanie wydajności dodaje do komunikatów logu tag Firebase/Performance, dzięki czemu możesz je filtrować.

4. Sprawdź następujące typy logów, które wskazują, że Monitorowanie wydajności rejestruje zdarzenia dotyczące wydajności:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Kliknij adres URL, aby wyświetlić dane w konsoli Firebase. Aktualizacja danych w panelu może chwilę potrwać.

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 dodano pakiet SDK Performance Monitoring do aplikacji, gdy otrzyma ona z niej informacje o zdarzeniach (np. o interakcjach). Zazwyczaj w ciągu 10 minut od uruchomienia aplikacji pojawia się w panelu Wydajności konsoli Firebase 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 Monitorowanie wydajności 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 wyświetla komunikat, że wykryto pakiet SDK, ale nie są wyświetlane żadne dane

Monitorowanie wydajności przetwarza dane zdarzeń dotyczących wydajności, zanim zostaną wyświetlone w panelu Skuteczność.

Jeśli od wyświetlenia komunikatu „Wykryto pakiet SDK” minęły ponad 24 godziny, a dane są nadal niewidoczne, sprawdź w Panelu stanu Firebase, czy nie doszło do znanej przerwy w działaniu usługi. 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 nie jest wyłączony za pomocą jednej z tych flag w pliku Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Upewnij się, że Monitorowanie wydajności nie jest wyłączone w czasie działania (Swift | Obj-C).

3. Jeśli nie widzisz niczego, co jest wyłączone w aplikacji, skontaktuj się z zespołem pomocy Firebase.

W panelu wydajności brakuje danych zrzutu ekranu

Jeśli brakuje danych śledzenia renderowania ekranu, wypróbuj te rozwiązania:

W panelu wydajności brakuje niestandardowych danych logu czasu

Czy widzisz dane o wydajności logów zbieranych automatycznie, ale nie niestandardowych logów czasu? Aby spróbować go rozwiązać, wykonaj te czynności:

1. Sprawdź konfigurację niestandardowych logów czasu kodu wykorzystujących interfejs Trace API, a zwłaszcza te dane:

   • Nazwy niestandardowych logów czasu kodu i wskaźników niestandardowych muszą spełniać te wymagania: bez odstępów na początku ani na końcu, bez znaku podkreślenia (_), a 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.

2. Sprawdź komunikaty logu, aby upewnić się, że Monitorowanie wydajności rejestruje oczekiwane niestandardowe logi czasu kodu.

3. Jeśli Monitorowanie wydajności rejestruje zdarzenia, ale po 24 godzinach nie wyświetlają się żadne dane, skontaktuj się z zespołem pomocy Firebase.

W panelu wydajności brakuje danych dotyczących żądań sieciowych

Jeśli brakuje danych dotyczących żądań sieciowych, wykonaj te czynności, by rozwiązać problem:

1. Sprawdź niezgodność biblioteki sieciowej. Monitorowanie wydajności automatycznie zbiera wskaźniki dotyczące żądań sieciowych, które korzystają z tych bibliotek sieciowych:

   • W przypadku kodu Swift: URLSession i URLConnection
   • W narzędziu Objective-C: NSURLSession i NSURLConnection

   Pamiętaj, że możesz dodać monitorowanie niestandardowe na potrzeby żądań sieciowych.

2. Pamiętaj:

   • W zależności od sposobu działania kodu i używanych przez niego bibliotek sieciowych Monitorowanie wydajności może generować raporty tylko o ukończonych żądaniach sieciowych. Oznacza to, że otwarte połączenia HTTP/S mogą nie być zgłaszane.

   • Monitorowanie wydajności nie raportuje żądań sieciowych z nieprawidłowymi nagłówkami Content-Type. Jednak żądania sieciowe bez nagłówków Content-Type będą nadal akceptowane.

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

Dowiedz się więcej o tym, jak Monitorowanie wydajności agreguje dane żądań sieciowych we wzorcach adresów URL.

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

Co się stało z Najważniejsze problemy na karcie Skuteczność 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 najnowsze alerty dla 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?

Monitorowanie wydajności obsługuje alerty dotyczące wskaźników, które przekraczają 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 o konkretnym logu czasu.

Dlaczego liczba próbek jest niezgodna z oczekiwaniami?

Monitorowanie wydajności zbiera dane o wydajności z urządzeń użytkowników Twojej aplikacji. Jeśli aplikacja ma wielu użytkowników lub generuje dużą aktywność związaną z wydajnością, monitorowanie wydajności może ograniczyć zbieranie danych do podzbioru urządzeń, aby zmniejszyć liczbę przetworzonych zdarzeń. Limity te są na tyle wysokie, że nawet w przypadku mniejszej liczby zdarzeń wartości danych odzwierciedlają wrażenia użytkowników.

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

• Ograniczenie szybkości na urządzeniu: aby zapobiec wysyłaniu przez urządzenie nagłych serii śledzenia, ograniczamy liczbę logów czasu i żądań sieciowych 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: Monitorowanie wydajności gromadzi około 100 mln zdarzeń w przypadku logów czasu kodu i 100 mln danych śledzenia żądań sieciowych na aplikację dziennie dla wszystkich użytkowników aplikacji. Częstotliwość próbkowania dynamicznego jest pobierana z urządzeń (za pomocą Zdalnej konfiguracji Firebase), aby określić, czy losowe urządzenie powinno przechwycić i przesłać logi czasu. Urządzenie, które nie zostało wybrane do próbkowania, nie wysyła żadnych zdarzeń. Częstotliwość próbkowania dynamicznego jest związana z aplikacją i dostosowuje się tak, aby ogólna ilość zebranych danych nie przekraczała 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, Monitorowanie wydajności może też ograniczać liczbę sesji.

• Ograniczenie szybkości po stronie serwera: aby zapobiec przekroczeniu limitu próbkowania, Monitorowanie wydajności może używać próbkowania po stronie serwera, aby pomijać niektóre zdarzenia odebrane z urządzeń. Chociaż to ograniczenie nie zmienia skuteczności naszych danych, może powodować drobne zmiany wzorców, 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?

Zastąpiliśmy kartę Problemy teraz funkcją Alerty, która automatycznie powiadamia Cię o przekroczeniu ustawionych przez Ciebie progów. Nie musisz już ręcznie sprawdzać stanu progu w konsoli Firebase. Więcej informacji o Alertach Google 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 były na tych stronach?

Przeprojektowaliśmy sekcję Monitorowanie wydajności w konsoli Firebase, tak aby na karcie Panel były widoczne 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 wskaźniki i dane z określonego logu czasu, kliknij jego nazwę w tabeli logów czasu.

Logi możesz wyświetlić na tych podkartach w tabeli logów czasu:

• Logi czasu żądań sieciowych (zarówno gotowe, jak i niestandardowe) – podkarta Żądania sieciowe
• Niestandardowe logi czasu – podkarta Niestandardowe logi czasu
• Uruchamianie aplikacji, śledzenie aplikacji na pierwszym planie i śledzenie aplikacji w tle – podkarta Niestandardowe logi czasu
• Ślady renderowania ekranu – podkarta Renderowanie ekranu
• Ślady wczytywania strony – podkarta Wczytanie strony

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

Dlaczego liczba spowolnionych i zablokowanych klatek jest niezgodna z oczekiwaniami?

Klatki renderowane z powolnym renderowaniem i zablokowane klatki są obliczane z zakładaną częstotliwością odświeżania urządzenia wynoszącą 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ę. Dłuższe renderowanie może spowodować, że w raportach będzie raportowanych więcej spowolnionych lub zablokowanych klatek, ponieważ więcej klatek będzie renderowanych wolniej lub zatrzyma się. 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ć uwzględnianie w raportach mniejszej liczby spowolnionych lub zablokowanych klatek. Jest to obecne ograniczenie w pakiecie SDK Performance Monitoring.

Eksportowanie danych z monitorowania wydajności do BigQuery trwa dłużej niż oczekiwano. Czy to nie czas rzeczywisty?

Jeśli masz włączoną integrację BigQuery z Monitorowaniem wydajności Firebase, Twoje dane zostaną wyeksportowane do BigQuery w ciągu 12–24 godzin po zakończeniu dnia (czasu pacyficznego).

Na przykład dane z 19 kwietnia będą dostępne w BigQuery 20 kwietnia między 12:00 a północą (wszystkie daty i godziny są podane w czasie pacyficznym).

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

Monitorowanie wydajności Firebase przetwarza zebrane dane o skutecznoś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, dlatego tu pojawia się określenie „w czasie rzeczywistym”.

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

Jak uzyskać dane o działaniu aplikacji aktualizowane w czasie zbliżonym do rzeczywistego?

Aby korzystać z 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 zgodnego 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 w wersji 26.1.0 lub nowszej)
• Internet – 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 Monitorowanie wydajności przetwarzanie danych w czasie zbliżonym do rzeczywistego.

Które wersje pakietu SDK Performance Monitoring są uznawane 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 (albo Firebase Android BoM w wersji 26.1.0 lub nowszej)
• Internet – 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 Monitorowanie wydajności 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 danymi w czasie rzeczywistym?

Jeśli Twoja aplikacja nie korzysta z wersji pakietu SDK zgodnej z danymi w czasie rzeczywistym, wszystkie dane o jej działaniu będą widoczne w konsoli Firebase. Wyświetlenie danych o skuteczności będzie jednak opóźnione o około 36 godzin od momentu ich zebrania.

Pakiet SDK został zaktualizowany do wersji zgodnej w czasie rzeczywistym, ale niektórzy użytkownicy nadal korzystają ze starszych wersji mojej aplikacji. Czy nadal będę widzieć ich dane o wydajności w konsoli Firebase?

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

Jeśli jednak analizujesz najnowsze dane (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.