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

   1. W Xcode (minimum v12.5), wybierz schemat produktu> Schemat> Edytuj.
   2. Wybierz polecenie Uruchom z menu po lewej stronie, a następnie wybierz kartę argumentów.
   3. W Argumenty przekazywane w sekcji uruchamianie, dodać -FIRDebugEnabled .

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

3. Monitorowanie wydajności tagi swoje komunikaty dziennika z Firebase/Performance , dzięki czemu można filtrować wiadomości dziennika.

4. Sprawdź następujące typy dzienników, które wskazują, że funkcja Performance Monitoring 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ć swoje dane w konsoli Firebase. Aktualizacja danych w panelu może zająć kilka chwil.

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 partiach SDK zdarzenia lokalnie, a następnie wysyła je do Firebase okresowo lub gdy aplikacja wraca do planie. Istnieje więc opóźnienie między interakcją w aplikacji a otrzymaniem przez Firebase informacji o zdarzeniu z Twojej aplikacji.

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

   1. Kontynuuj tworzenie aplikacji za pomocą symulatora lub urządzenia testowego.

   2. Generuj zdarzenia, kilkakrotnie przełączając aplikację między tłem a pierwszym planem, wchodząc w interakcję z aplikacją poprzez nawigowanie po ekranach i/lub wyzwalając żądania sieciowe.

2. Upewnij się, że Firebase plik konfiguracyjny ( Google-Service-Info.plist ) jest poprawnie dodany do aplikacji, a które nie zostały zmodyfikowane plik. W szczególności sprawdź następujące elementy:

   • Nazwa pliku config nie jest dołączany z dodatkowymi znakami, jak (2) .

   • Plik konfiguracyjny znajduje się w katalogu głównym projektu XCode i został dodany do poprawnych obiektów docelowych.

   • Firebase Apple App ID ( GOOGLE_APP_ID ) wymienione w pliku 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 plikiem konfiguracyjnym w Twojej aplikacji, spróbuj wykonać następujące czynności:

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

   2. Postępuj zgodnie z poniższymi instrukcjami , aby pobrać nowy plik konfiguracyjny i dodać go do swojej aplikacji Apple.

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 Monitorowanie wydajności SDK nie jest wyłączone przez jedną z następujących flag w swojej Info.plist pliku:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

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

3. 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 Monitorowanie wydajności SDK nie jest wyłączone przez jedną z następujących flag w swojej Info.plist pliku:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

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

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

W panelu wydajności brakuje danych śledzenia ekranu

Jeśli brakuje danych dotyczących śladów renderowania ekranu, wypróbuj następujące kroki rozwiązywania problemów:

1. Upewnij się, że używasz najnowszej wersji zestawu SDK platformy Apple (wersja 8.10.0). Ślady renderowania ekranu są dostępne tylko w wersji 5.0.0 lub nowszej.

2. Monitorowanie wydajności nie tworzy ekran dla renderowania ślady widok pojemnika sterowników (takie jak UINavigationController i UITabBarController ). Jeśli brakuje danych tylko dla tych ekranów, jest to oczekiwane zachowanie.

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.

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

3. 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 żądań sieciowych, spróbuj wykonać następujące kroki rozwiązywania problemów:

1. Sprawdź niezgodność biblioteki sieciowej. Monitorowanie wydajności automatycznie zbiera dane dotyczące zapytań sieciowych , które korzystają z następujących bibliotek sieciowych:

   • Swift: URLSession i URLConnection
   • Dla celu C: NSURLSession i NSURLConnection

   Należy pamiętać, że można dodać niestandardowe monitorowanie zapytań sieciowych .

2. Pamiętaj o następujących kwestiach:

   • 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.

   • Monitorowanie wydajności nie zgłasza się na żądania sieciowe z nieprawidłowymi Content-Type nagłówków. Jednak żądania sieciowe bez Content-Type nagłówków nadal będą akceptowane.

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ń .

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

Jeśli włączysz integrację BigQuery z monitorowaniem wydajności Firebase, Twoje dane zostaną wyeksportowane do BigQuery od 12 do 24 godzin po zakończeniu dnia (czas pacyficzny).

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 to czas pacyficzny).

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 .