Używaj Performance Monitoringalertów, aby powiadamiać członków zespołu projektu, jeśli zmiany w kodzie lub żądania sieciowe pogarszają wydajność aplikacji.
Możesz skonfigurować i dostosować alerty dotyczące aplikacji, które będą Cię powiadamiać, gdy skuteczność wydarzenia przekroczy określony próg.
Co wywołuje alert?
Alert jest wywoływany, gdy wartość danych aplikacji przekroczy próg, który określisz dla danego percentyla (w stosownych przypadkach) w Firebase konsoli. Alerty są wywoływane tylko wtedy, gdy aplikacja używa wersji pakietu SDK zgodnej z czasem rzeczywistym.
czas uruchamiania aplikacji,
Gdy skonfigurujesz alert dotyczący czasu uruchamiania aplikacji, zostanie on wywołany, jeśli spełnione są wszystkie te warunki:
- Firebase zarejestrował co najmniej
100 próbek _app_startśladu w przypadku najnowszej wersji Twojej aplikacji w ciągu ostatniej godziny. - Czas trwania śladu
_app_startprzekroczył zdefiniowany w aplikacji próg w ciągu ostatniej godziny i dla skonfigurowanego percentyla. - W najnowszej wersji aplikacji nie było wcześniej alertu dotyczącego tego samego progu.
logi czasu kodu niestandardowego,
Gdy skonfigurujesz alert dla danych śledzenia kodu niestandardowego, zostanie on wywołany, jeśli spełnione są wszystkie te warunki:
- Firebase zarejestrował co najmniej
100 próbek śledzenia kodu niestandardowego w przypadku najnowszej wersji aplikacji w ciągu ostatniej godziny. - Czas trwania śladu przekroczył zdefiniowany w aplikacji próg w ciągu ostatniej godziny i dla skonfigurowanego percentyla.
- (Tylko w przypadku iOS+ i Androida) W najnowszej wersji aplikacji nie było wcześniej alertu dotyczącego tego samego progu.
- (Tylko w przypadku internetu) W ciągu ostatnich
3 dni nie pojawił się wcześniej alert dotyczący tego samego progu.
żądania sieciowe,
Gdy skonfigurujesz alert dotyczący wskaźnika żądań sieciowych, zostanie on aktywowany, jeśli spełnione są 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 Twojej aplikacji. - Wartość zagregowana danych przekroczyła zdefiniowany próg w ciągu ostatniej godziny:
- czas odpowiedzi: zagregowana wartość przekroczyła ustawiony próg dla skonfigurowanego centyla.
- Wskaźnik sukcesu: (tylko iOS+/Android) zagregowana wartość spadła poniżej ustawionego progu u wszystkich użytkowników.
- W ciągu ostatnich
3 dni nie pojawił się wcześniej alert dotyczący tego samego progu.
renderowanie ekranu,
Jeśli skonfigurujesz alert dotyczący danych o renderowaniu ekranu, zostanie on wywołany, gdy spełnione będą wszystkie te warunki:
- W ciągu ostatniej godziny Firebase zarejestrował co najmniej
100 próbek renderowania ekranu w najnowszej wersji Twojej aplikacji. - Wartość zagregowana danych przekroczyła zdefiniowany próg w ciągu ostatniej godziny:
- zablokowane klatki: zagregowana wartość 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.
wczytania strony,
Jeśli skonfigurujesz alert dla wskaźnika wczytywania strony, zostanie on aktywowany, gdy spełnione będą wszystkie te warunki:
- W ciągu ostatniej godziny Firebase zarejestrował co najmniej
100 próbek wczytywania strony w Twojej aplikacji. - Wartość zagregowana danych przekroczyła zdefiniowany próg w ciągu ostatniej godziny i 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 pojawił się wcześniej alert dotyczący tego samego progu.
Dowiedz się więcej o konfigurowaniu alertów, domyślnych wartościach procentowych i sprawdzonych metodach konfigurowania alertów dotyczących określonych typów śladów i danych.
Alerty dotyczące innych danych o skuteczności lub wbudowanych integracji Firebase z Slackiem, Jirą i PagerDuty nie są dostępne w przypadku alertów Performance Monitoring.
Otrzymywanie alertów
Otrzymywanie domyślnych alertów
Domyślnie Firebase może wysyłać Performance Monitoring alerty e-mailem.
Aby otrzymywać alerty Performance Monitoring za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienia firebaseperformance.config.update. Te role domyślnie obejmują to wymagane uprawnienie:
- Administrator wydajności Firebase
- 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 członek projektu otrzyma e-maila, gdy zostanie uruchomiony alert dotyczący wydajności. Alerty są wysyłane tylko do członków projektu, którzy mają odpowiednie uprawnienia do ich otrzymywania, 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 własnym 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ć Performance Monitoring alerty, wykonaj te czynności:
- W konsoli Firebase w prawym górnym rogu otwórz
alerty Firebase . - Następnie kliknij
Ustawienia i ustaw preferencje konta dotyczące Performance Monitoring alertów.
Konfigurowanie zaawansowanych alertów w usługach innych firm
Możesz też wysyłać Performance Monitoringalerty do preferowanego kanału powiadomień zespołuCloud Functions for Firebase. Możesz na przykład napisać funkcję, która rejestruje zdarzenie alertu dotyczące długiego czasu uruchamiania aplikacji i przesyła informacje o alercie do usługi innej firmy, takiej jak Discord, Slack lub Jira.
Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase, wykonując te czynności:
- Skonfiguruj ś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 wdroż funkcję, która przechwytuje zdarzenie alertu z Performance Monitoring i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).
Wszystkie zdarzenia alertów o wydajności, które możesz rejestrować, znajdziesz w dokumentacji referencyjnej alertów Monitorowania wydajności.
Automatyczne usuwanie nieprawidłowych alertów
Performance Monitoring weryfikuje alerty, aby mieć pewność, że dane są prawidłowe i że 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 w ciągu ostatnich 90 dni otrzymano dane Performance Monitoring.
- 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 według niestandardowych wzorców adresów URL.
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 w Firebase, Administrator Firebase oraz Właściciel lub Edytujący projektu.
Jeśli jeszcze tego nie zrobiono, dodaj do aplikacji najnowszy pakiet SDK Performance Monitoring. 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 śladów lub karty raportu w panelu, aby skonfigurować alert dla każdego rodzaju danych, które chcesz monitorować. Każda aplikacja może mieć inny zestaw alertów, a każdy z nich może mieć inny próg (lub nie mieć żadnych alertów).
Konfigurowanie alertu w tabeli Logi czasu
W Performance Monitoringkonsoli otwórz kartę Panel Firebase i wybierz aplikację, dla której chcesz skonfigurować alert.
Przewiń w dół do tabeli Ślady u dołu ekranu.
Wybierz kartę typu śladu, dla którego chcesz ustawić alert, a następnie znajdź odpowiedni wiersz.
Po prawej stronie wiersza otwórz menu przepełnienia () i wybierz Ustawienia alertów.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić próg alertu i wartość procentową (w stosownych przypadkach) dla aplikacji lub włączyć/wyłączyć alert. Domyślne wartości procentowe to 90% w przypadku Androida i iOS oraz 75% w przypadku sieci. Więcej informacji o domyślnych wartościach procentowych znajdziesz w artykule Śledzenie kluczowych danych w panelu.
Konfigurowanie alertu na karcie raportu w panelu
W Performance Monitoringkonsoli otwórz kartę Panel Firebase i wybierz aplikację, dla której chcesz skonfigurować alert.
Na karcie Karty raportu znajdź kartę danych, dla której chcesz skonfigurować alert.
Na wybranej karcie danych otwórz menu rozwijane i wybierz Ustawienia alertów.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić próg alertu i wartość procentową (w stosownych przypadkach) dla aplikacji lub włączyć/wyłączyć alert. Domyślne wartości procentowe to 90% w przypadku Androida i iOS oraz 75% w przypadku sieci. Więcej informacji o domyślnych wartościach procentowych znajdziesz w artykule Śledzenie kluczowych danych w panelu.
Sprawdzone metody ustawiania alertu o skuteczności
Żądania sieciowe
Firebase agreguje dane z podobnych żądań sieciowych w ramach wzorców adresów URL, które mogą być:
wzorców zdefiniowanych 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 wzorców korzystania z aplikacji.
Ustawianie alertów dotyczących niestandardowych wzorców adresów URL
Zalecamy skonfigurowanie alertów dotyczących wszystkich skonfigurowanych przez Ciebie niestandardowych wzorców URL. Firebase najpierw próbuje dopasować żądanie do niestandardowego wzorca adresu URL, więc podobne żądania są bardziej spójnie mapowane na ten sam wzorzec adresu URL. Dzięki temu alerty dotyczące niestandardowego wzorca adresu URL będą bardziej przydatne i skuteczne dla Twojego zespołu, ponieważ ten konkretny wzorzec żądań został już przez Ciebie uznany za ważny dla aplikacji.
Konfigurowanie alertów dotyczących automatycznych wzorców URL
Podczas konfigurowania alertu dotyczącego automatycznego wzorca adresu URL upewnij się, że automatyczny wzorzec adresu URL 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 interesujących Cię wzorców będą nieprawidłowe lub niekompletne. Możesz też utworzyć niestandardowy wzorzec adresu URL, aby zapewnić jego stabilność.
Wczytywanie strony internetowej
Zalecane progi pomiaru wskaźników internetowych znajdziesz w dokumentacji podstawowych wskaźników internetowych.
Renderowanie ekranu
Aby zapewnić optymalne działanie aplikacji, sesje użytkowników nie powinny zawierać powolnych i zablokowanych klatek. Performance Monitoring zaleca skonfigurowanie alertów o zablokowanych klatkach, których odsetek przekracza 1%, oraz alertów o wolnych klatkach, których odsetek przekracza 5%. Podczas konfigurowania alertu o wydajności zobaczysz, że te wartości są ustawieniami domyślnymi. Więcej informacji o nadmiernej liczbie wolnych lub zablokowanych klatek oraz innych sprawdzonych metodach dotyczących wydajności aplikacji znajdziesz w wskazówkach Google Play.