Używaj alertów Performance Monitoring, aby powiadamiać członków projektu, jeśli zmiany w kodzie lub żądania sieciowe obniżają wydajność aplikacji.
Możesz skonfigurować i dostosować alerty dotyczące aplikacji, które będą Cię powiadamiać, gdy skuteczność zdarzenia przekroczy określony próg.
Co powoduje wysłanie alertu?
Alert jest wywoływany, gdy dane aplikacji przekroczą próg określony dla danego percentyla (jeśli dotyczy) w konsoli Firebase. Alerty są wywoływane tylko wtedy, gdy aplikacja używa wersji pakietu SDK zgodnej z funkcją alertów w czasie rzeczywistym.
czas uruchomienia aplikacji
Gdy skonfigurujesz alert dotyczący czasu rozpoczęcia aplikacji, zostanie on aktywowany, jeśli spełnione będą wszystkie te warunki:
- W ciągu ostatniej godziny Firebase zarejestrował co najmniej
100 próbek śladu_app_startw najnowszej wersji aplikacji. - Czas trwania logu czasu
_app_startprzekroczył zdefiniowany próg aplikacji w ciągu ostatniej godziny i dla skonfigurowanego percentyla. - W najnowszej wersji aplikacji nie było wcześniej alertu dotyczącego tego samego progu.
ślady niestandardowego kodu
Gdy skonfigurujesz alert dotyczący niestandardowego wskaźnika śledzenia kodu, zostanie on aktywowany, jeśli spełnione będą wszystkie te warunki:
- W ciągu ostatniej godziny Firebase zarejestrował co najmniej
100 próbek śladu kodu niestandardowego w najnowszej wersji aplikacji. - W ciągu ostatniej godziny czas trwania śladu przekroczył próg zdefiniowany w aplikacji dla skonfigurowanego percentyla.
- (Tylko w przypadku iOS+ i Androida) Nie było wcześniej alertu dotyczącego tego samego progu w najnowszej wersji aplikacji.
- (Tylko w przypadku internetu) W ciągu ostatnich
3 dni nie wygenerowano wcześniej alertu dotyczącego tego samego progu.
żądania sieciowe
Gdy skonfigurujesz alert dotyczący wskaźnika żądania sieciowego, zostanie on aktywowany, jeśli zostaną spełnione wszystkie te warunki:
- W ciągu ostatniej godziny Firebase zarejestrował co najmniej
100 próbek , które pasowały do wzorca adresu URL we wszystkich wersjach aplikacji. - W ciągu ostatniej godziny zagregowana wartość danych przekroczyła określony próg:
- czas odpowiedzi: zagregowana wartość przekroczyła ustawiony próg dla skonfigurowanego centyla,
- wskaźnik sukcesu: (tylko w przypadku iOS+/Androida) wartość zbiorcza spadła poniżej ustawionego progu u wszystkich użytkowników;
- W ciągu ostatnich
3 dni nie został wygenerowany żaden alert dotyczący tego samego progu.
renderowanie ekranu
Gdy skonfigurujesz alert dotyczący danych renderowania ekranu, zostanie on aktywowany, jeśli zostaną spełnione wszystkie te warunki:
- Firebase zarejestrował co najmniej
100 próbek renderowania ekranu w najnowszej wersji aplikacji w ciągu ostatniej godziny. - W ciągu ostatniej godziny zagregowana wartość danych przekroczyła określony próg:
- zablokowane klatki: wartość zagregowana przekroczyła ustawiony próg,
- spowolnione klatki: zagregowana wartość przekroczyła ustawiony próg,
- W najnowszej wersji aplikacji nie było wcześniej alertu dotyczącego tego samego progu.
wczytanie strony,
Gdy skonfigurujesz alert dotyczący danych o wczytywaniu strony, zostanie on aktywowany, jeśli spełnione będą wszystkie te warunki:
- Firebase zarejestrował co najmniej
100 próbek wczytywania strony w Twojej aplikacji w ciągu ostatniej godziny. - W ciągu ostatniej godziny zagregowana wartość danych przekroczyła określony próg dla skonfigurowanego percentyla:
- opóźnienie przy pierwszym działaniu: zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl;
- pierwsze wyrenderowanie treści: zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl.
- pierwsze wyrenderowanie: zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl;
- W ciągu ostatnich
3 dni nie wygenerowano wcześniej alertu dla tego samego progu.
Dowiedz się więcej o konfigurowaniu alertów, domyślnych percentylach i sprawdzonych metodach konfigurowania alertów dotyczących określonych typów logów czasu i danych.
Alerty dotyczące innych wskaźników wydajności lub integracji ze Slackiem, Jirą lub PagerDuty skonfigurowanych w konsoli Firebase nie są dostępne w przypadku alertów Performance Monitoring.
Otrzymywanie alertów
Otrzymywanie alertów domyślnych
Domyślnie Firebase może wysyłać alerty Performance Monitoring e-mailem.
Aby otrzymywać alerty Performance Monitoring za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie firebaseperformance.config.update. Te role domyślnie obejmują to wymagane uprawnienie:
- Administrator Firebase Performance
- Administrator jakości w Firebase
- Administrator Firebase
- Właściciel lub Edytujący projektu
Alerty i ich ustawienia dotyczą całego projektu. Oznacza to, że domyślnie każdy użytkownik projektu otrzyma e-maila, gdy zostanie wygenerowany alert dotyczący działania aplikacji. Alerty są wysyłane tylko do użytkowników projektu, którzy mają wymagane uprawnienia do otrzymywania alertów, oraz na poszczególne adresy e-mail (nie do grup kont, takich jak Grupy dyskusyjne Google czy konta Google Workspace).
Włączanie i wyłączanie alertów na własnym koncie
Na swoim koncie możesz włączać i wyłączać alerty Performance Monitoring bez wpływu na innych członków projektu. Pamiętaj, że aby otrzymywać alerty, nadal musisz mieć wymagane uprawnienia.
Aby włączyć lub wyłączyć alerty Performance Monitoring, wykonaj te czynności:
- W prawym górnym rogu konsoli Firebase kliknij
Alerty Firebase . - Następnie otwórz
Ustawienia i ustaw ustawienia konta dotyczące alertów Performance Monitoring.
Konfigurowanie zaawansowanych alertów dla usług innych firm
Możesz też wysyłać alerty Performance Monitoring do preferowanego kanału powiadomień zespołu za pomocą Cloud Functions for Firebase. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu o wolnym czasie rozpoczęcia aplikacji i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack czy Jira.
Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase, co obejmuje te zadania:
- skonfigurować środowisko programistyczne dla Node.js lub Pythona,
- Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.
- Zainicjuj Cloud Functions for Firebase za pomocą interfejsu wiersza poleceń Firebase.
Napisz i wdróż funkcję, która przechwytuje zdarzenie alertu z Performance Monitoring i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).
Aby dowiedzieć się więcej o wszystkich zdarzeniach alertów dotyczących wydajności, które możesz rejestrować, zapoznaj się z dokumentacją referencyjną dotyczącą alertów Monitorowania wydajności.
Automatyczne usuwanie nieprawidłowych alertów
Performance Monitoring sprawdza alerty, aby upewnić się, że dane są prawidłowe, a alerty są aktywnie używane. Alerty są uznawane za prawidłowe, jeśli spełniony jest jeden z tych warunków:
- Alert jest tworzony dla identyfikatora zasobu, dla którego usługa Performance Monitoring otrzymała dane w ciągu ostatnich 90 dni.
- Alert został niedawno utworzony dla niestandardowego wzorca adresu URL. Po utworzeniu niestandardowego wzorca adresu URL i skonfigurowaniu alertu masz 90 dni na wysłanie danych dotyczących tego wzorca. Jeśli w ciągu 90 dni nie zostaną wysłane żadne dane, Performance Monitoring usunie ten alert. Więcej informacji o niestandardowych wzorcach adresów URL znajdziesz w artykule Zbieranie danych na podstawie wzorców adresów URL klientów.
Jeśli którykolwiek z tych warunków nie zostanie spełniony, Performance Monitoring usunie alert.
Konfigurowanie alertu
Aby skonfigurować alerty Performance Monitoring, musisz mieć uprawnienie firebaseperformance.config.update. To wymagane uprawnienie jest domyślnie uwzględnione w tych rolach:
Administrator wydajności Firebase,
Administrator jakości Firebase,
Administrator Firebase,
Właściciel lub Edytujący projektu.
Jeśli jeszcze nie masz najnowszego pakietu SDK Performance Monitoring, dodaj go do aplikacji. Więcej informacji znajdziesz w przewodnikach dla początkujących dotyczących platform internetowych, Android, Apple i Flutter.
W każdej zarejestrowanej aplikacji użyj tabeli logów czasu lub karty raportu w panelu, aby skonfigurować alert dla każdego rodzaju danych, który chcesz monitorować. Każda aplikacja może mieć inny zestaw alertów, z których każdy ma inny próg (lub nie ma żadnych alertów).
Konfigurowanie alertu w tabeli logów czasu
W konsoli Firebase otwórz kartę Performance Monitoring Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.
Przewiń w dół do tabeli Ślady u dołu ekranu.
Wybierz kartę typu logu czasu, dla którego chcesz ustawić alert, a następnie znajdź odpowiedni wiersz.
Po prawej stronie wiersza otwórz rozszerzone menu () i wybierz Ustawienia alertów.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić próg alertu i percentyl (jeśli dotyczy) dla aplikacji lub włączyć/wyłączyć alert. Domyślne percentyle to 90 w przypadku Androida i iOS oraz 75 w przypadku internetu. Więcej informacji o domyślnych percentylach znajdziesz w artykule Śledzenie kluczowych danych w panelu.
Konfigurowanie alertu na karcie raportu w panelu
W konsoli Firebase otwórz kartę Performance Monitoring Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.
Na karcie Raport znajdź kartę danych, dla której chcesz skonfigurować alert.
Na karcie odpowiednich danych otwórz rozszerzone menu () i wybierz Ustawienia alertów.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić próg alertu i percentyl (jeśli dotyczy) dla aplikacji lub włączyć/wyłączyć alert. Domyślne percentyle to 90 w przypadku Androida i iOS oraz 75 w przypadku internetu. Więcej informacji o domyślnych percentylach znajdziesz w artykule Śledzenie kluczowych danych w panelu.
Sprawdzone metody ustawiania alertu dotyczącego działania aplikacji
Żądania sieciowe
Firebase agreguje dane z podobnych żądań sieciowych we wzorcach adresów URL, które mogą być:
Wzorce zdefiniowane przez użytkownika, które są nazywane niestandardowymi wzorcami adresów URL.
wzorce pochodzące z Firebase, które są nazywane automatycznymi wzorcami adresów URL;
Te wzorce mogą się zmieniać w zależności od najnowszych sposobów korzystania z aplikacji.
Konfigurowanie alertów dotyczących niestandardowych wzorców adresów URL
Zalecamy skonfigurowanie alertów dla wszystkich skonfigurowanych niestandardowych wzorców adresów URL. Firebase najpierw próbuje dopasować żądanie do niestandardowego wzorca adresu URL, dzięki czemu podobne żądania są bardziej spójnie mapowane na ten sam wzorzec adresu URL. Dzięki temu alerty dotyczące niestandardowego wzorca adresu URL są bardziej przydatne i skuteczne dla Twojego zespołu, ponieważ ten konkretny wzorzec żądań został już przez Ciebie zidentyfikowany jako ważny dla aplikacji.
Konfigurowanie alertów dotyczących automatycznych wzorców adresów URL
Podczas konfigurowania alertu dotyczącego automatycznego wzorca adresu URL upewnij się, że wzorzec ten jest stabilny od kilku dni. Pamiętaj, że automatyczne wzorce adresów URL mogą się z czasem zmieniać, a konfiguracje alertów nie są przenoszone do nowych wzorców adresów URL. Może to spowodować, że alerty dotyczące wzorców, które Cię interesują, będą nieprawidłowe lub nie będą się pojawiać. Możesz też utworzyć niestandardowy wzorzec adresu URL, aby mieć pewność, że jest on stabilny.
Wczytanie strony internetowej
Zalecane progi pomiaru danych internetowych znajdziesz w dokumentacji Core Web Vitals.
Renderowanie ekranu
Aby zapewnić optymalne wrażenia użytkownika aplikacji, sesje użytkowników powinny być wolne od powolnych i zawieszonych klatek. Performance Monitoring zaleca skonfigurowanie alertów dotyczących zamrożonych klatek powyżej 1% oraz alertów dotyczących powolnych klatek powyżej 5%. Te wartości są domyślnymi ustawieniami podczas konfigurowania alertów dotyczących działania aplikacji. Więcej informacji o nadmiernej liczbie powolnych lub zablokowanych klatek oraz o innych sprawdzonych metodach dotyczących wydajności aplikacji znajdziesz we wskazówkach Google Play.