Użyj alertów monitorowania wydajności, aby powiadomić członków projektu, jeśli zmiany w kodzie lub żądania sieciowe obniżają wydajność Twojej aplikacji.
Możesz skonfigurować i dostosować alerty dla swojej aplikacji, które powiadamiają Cię, gdy wydajność zdarzenia przekroczy ustalony próg.
Co wyzwala alert?
Alert jest wyzwalany, gdy dane dotyczące Twojej aplikacji przekroczą próg zdefiniowany dla określonego percentyla (jeśli dotyczy) w konsoli Firebase. Alerty są wyzwalane tylko wtedy, gdy Twoja aplikacja korzysta z wersji pakietu SDK zgodnej z działaniem w czasie rzeczywistym .
czas uruchomienia aplikacji
Podczas konfigurowania alertu dotyczącego czasu uruchomienia aplikacji alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:
- Firebase zarejestrowała co najmniej
100 próbek śladu_app_startdla najnowszej wersji Twojej aplikacji w ciągu ostatniej godziny. - Czas trwania śledzenia
_app_startprzekroczył próg zdefiniowany przez aplikację w ciągu ostatniej godziny i dla skonfigurowanego percentyla. - W najnowszej wersji Twojej aplikacji nie został wcześniej zgłoszony żaden alert dotyczący tego samego progu.
niestandardowe ślady kodu
Podczas konfigurowania alertu dla niestandardowej metryki śledzenia kodu alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:
- W ciągu ostatniej godziny Firebase zarejestrowała co najmniej
100 próbek niestandardowego śledzenia kodu dla najnowszej wersji Twojej aplikacji. - Czas trwania śledzenia przekroczył próg zdefiniowany przez aplikację w ciągu ostatniej godziny i dla skonfigurowanego percentyla.
- (Tylko dla systemów iOS+ i Android) W najnowszej wersji Twojej aplikacji nie został wcześniej zgłoszony żaden alert dotyczący tego samego progu.
- (Tylko w internecie) W ciągu ostatnich
3 dni nie zgłoszono wcześniej żadnego alertu dla tego samego progu.
żądania sieciowe
Podczas konfigurowania alertu dla metryki żądania sieciowego alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:
- W ciągu ostatniej godziny Firebase zarejestrowała co najmniej
100 próbek pasujących do wzorca adresu URL we wszystkich wersjach Twojej aplikacji. - Zagregowana wartość metryki przekroczyła określony próg w ciągu ostatniej godziny:
- czas odpowiedzi : zagregowana wartość przekroczyła ustawiony próg dla skonfigurowanego percentyla
- wskaźnik sukcesu : (tylko dla iOS+/Androida) zagregowana wartość spadła poniżej ustawionego progu dla wszystkich użytkowników
- W ciągu ostatnich
3 dni nie zgłoszono wcześniej żadnego alertu dla tego samego progu.
renderowanie ekranu
Podczas konfigurowania alertu dla metryki renderowania ekranu jest on wyzwalany, jeśli spełnione są wszystkie następujące warunki:
- Firebase zarejestrowała co najmniej
100 próbek renderowania ekranu dla najnowszej wersji Twojej aplikacji w ciągu ostatniej godziny. - Zagregowana wartość metryki przekroczyła określony próg w ciągu ostatniej godziny:
- zamrożone ramki : zagregowana wartość przekroczyła ustawiony próg
- wolne klatki : zagregowana wartość przekroczyła ustawiony próg
- W najnowszej wersji Twojej aplikacji nie został wcześniej zgłoszony żaden alert dotyczący tego samego progu.
ładuje się strona
Podczas konfigurowania alertu dla metryki ładowania strony jest on wyzwalany, jeśli spełnione są wszystkie poniższe warunki:
- Firebase zarejestrował co najmniej
100 próbek wczytywania strony Twojej aplikacji w ciągu ostatniej godziny. - Zagregowana wartość metryki przekroczyła zdefiniowany próg w ciągu ostatniej godziny i dla skonfigurowanego percentyla:
- opóźnienie pierwszego wejścia : zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl
- pierwsza farba treściwa : zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl
- pierwsza farba : zagregowana wartość przekroczyła ustawiony próg i skonfigurowany percentyl
- W ciągu ostatnich
3 dni nie zgłoszono wcześniej żadnego alertu dla tego samego progu.
Dowiedz się więcej o konfigurowaniu alertów , domyślnych percentylach i sprawdzonych metodach konfigurowania alertów dla określonych typów śledzenia i metryk.
Alerty dotyczące innych wskaźników wydajności lub wbudowanych integracji Firebase ze Slack , Jira i PagerDuty nie są dostępne dla alertów monitorowania wydajności.
Otrzymuj alerty
Otrzymuj domyślne alerty
Domyślnie Firebase może wysyłać alerty monitorowania wydajności pocztą e-mail.
Aby otrzymywać alerty monitorowania wydajności za pośrednictwem tego domyślnego mechanizmu, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie obejmują to wymagane uprawnienie:
- Administrator wydajności Firebase
- Administrator jakości Firebase
- Administrator Firebase
- Właściciel lub redaktor projektu
Alerty i ich ustawienia dotyczą całego projektu. Oznacza to, że domyślnie każdy członek projektu (który nie jest grupą e-mailową i ma wymagane uprawnienia do otrzymywania alertów) otrzyma wiadomość e-mail po wyzwoleniu alertu dotyczącego wydajności.
Włącz/wyłącz alerty dla własnego konta
Na własnym koncie możesz włączać/wyłączać alerty monitorowania wydajności bez wpływu na innych członków projektu. Pamiętaj, że nadal potrzebujesz wymaganych uprawnień, aby otrzymywać alerty.
Aby włączyć lub wyłączyć alerty monitorowania wydajności, wykonaj następujące kroki:
- W konsoli Firebase w prawym górnym rogu przejdź do Alerty Firebase .
- Następnie przejdź do ustawień Ustawienia ustaw preferencje konta dotyczące alertów monitorowania wydajności.
Skonfiguruj zaawansowane alerty do usług innych firm
Możesz też wysyłać alerty monitorowania wydajności do preferowanego kanału powiadomień swojego zespołu, korzystając z Cloud Functions dla Firebase. Na przykład możesz napisać funkcję, która przechwytuje zdarzenie alertu dotyczące wolnego czasu uruchamiania aplikacji i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack lub Jira.
Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions dla Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase , co obejmuje następujące zadania:
- Skonfiguruj środowisko programistyczne dla Node.js lub Python.
- Zainstaluj i zaloguj się do Firebase CLI.
- Zainicjuj Cloud Functions dla Firebase przy użyciu Firebase CLI.
Napisz i wdróż funkcję , która przechwytuje zdarzenie alertu z monitorowania wydajności i obsługuje ładunek zdarzenia (na przykład 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żna przechwytywać, przejdź do dokumentacji referencyjnej dotyczącej alertów monitorowania wydajności .
Automatyczne usuwanie nieważnych alertów
Monitorowanie wydajności weryfikuje alerty, aby upewnić się, że dane są prawidłowe i że alerty są aktywnie używane. Alerty są uważane za ważne, jeśli spełniony jest jeden z poniższych warunków:
- Alert jest tworzony dla identyfikatora zasobu, dla którego monitorowanie wydajności otrzymało 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 przesłanie danych dla tego wzorca. Jeśli żadne dane nie zostaną wysłane w ciągu 90 dni, monitorowanie wydajności usunie ten alert. Aby uzyskać więcej informacji na temat niestandardowych wzorców adresów URL, zobacz Agregowanie danych w sekcji Wzorce adresów URL klientów .
Jeśli którykolwiek z tych warunków nie jest spełniony, monitorowanie wydajności usuwa alert.
Skonfiguruj alert
Aby skonfigurować alerty monitorowania wydajności, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie zawierają to wymagane uprawnienie: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin oraz Project Owner or Editor .
Jeśli jeszcze tego nie zrobiłeś, dodaj najnowszy zestaw SDK do monitorowania wydajności do swojej aplikacji. Aby uzyskać więcej informacji, zobacz przewodniki wprowadzające dla platform internetowych , Android , Apple i Flutter .
W każdej z zarejestrowanych aplikacji użyj tabeli Traces lub karty raportu Pulpit nawigacyjny, aby skonfigurować alert dla każdej metryki, którą chcesz monitorować. Każda aplikacja może mieć inny zestaw alertów, każdy z innym progiem (lub nie mieć żadnych alertów).
Skonfiguruj alert w tabeli śledzenia
Przejdź do karty Pulpit nawigacyjny monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.
Przewiń w dół do tabeli Traces u dołu ekranu.
Wybierz kartę typu śledzenia, 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 percentyl (jeśli dotyczy) dla aplikacji lub włączyć/wyłączyć alert. Domyślne percentyle to 90. dla Androida i iOS oraz 75. dla Internetu. Aby dowiedzieć się więcej o domyślnych percentylach, zobacz Śledzenie kluczowych metryk na pulpicie nawigacyjnym .
Skonfiguruj alert na karcie raportu Pulpit nawigacyjny
Przejdź do karty Pulpit nawigacyjny monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.
Na karcie Karta raportu znajdź kartę metryki, dla której chcesz skonfigurować alert.
Na żądanej karcie metrycznej otwórz menu przepełnienia ( ) i wybierz opcję 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. dla Androida i iOS oraz 75. dla Internetu. Aby dowiedzieć się więcej o domyślnych percentylach, zobacz Śledzenie kluczowych metryk na pulpicie nawigacyjnym .
Najlepsze praktyki dotyczące ustawiania alertu dotyczącego wydajności
Żądania sieciowe
Firebase agreguje dane z podobnych żądań sieciowych według wzorców adresów URL, które mogą być jednym z następujących:
Wzorce zdefiniowane przez użytkownika, zwane niestandardowymi wzorcami adresów URL .
Wzorce pochodzące z Firebase, zwane automatycznymi wzorcami adresów URL .
Wzorce te mogą zmieniać się z czasem w zależności od ostatniego sposobu użytkowania aplikacji.
Skonfiguruj alerty dla niestandardowych wzorców adresów URL
Zalecamy skonfigurowanie alertów dla dowolnych skonfigurowanych niestandardowych wzorców adresów URL. Ponieważ Firebase najpierw próbuje dopasować żądanie do niestandardowego wzorca adresu URL, podobne żądania są bardziej konsekwentnie mapowane na ten sam wzorzec adresu URL. Dzięki temu alerty dotyczące niestandardowego wzorca adresów URL są bardziej znaczące i skuteczne dla Twojego zespołu, ponieważ już zidentyfikowałeś ten konkretny wzorzec żądań jako ważny dla Twojej aplikacji.
Skonfiguruj alerty dla automatycznych wzorców adresów URL
Konfigurując alert dotyczący automatycznego wzorca adresu URL, upewnij się, że wzorzec automatycznego adresu URL ustabilizował się przez kilka dni. Pamiętaj, że automatyczne wzorce adresów URL mogą się zmieniać z czasem, a konfiguracje alertów nie są przenoszone do nowych wzorców adresów URL. Może to spowodować nieprawidłowe lub brakujące alerty dotyczące wzorców, na których Ci zależy. Możesz także rozważyć utworzenie niestandardowego wzorca adresu URL, aby zapewnić stabilność tego wzorca.
Ładuje się strona internetowa
Aby poznać zalecane wartości progowe do pomiaru metryk internetowych, zapoznaj się z dokumentacją Core Web Vitals .
Renderowanie ekranu
Aby zapewnić optymalne działanie aplikacji, sesje użytkownika powinny być wolne i zawieszone. Monitorowanie wydajności zaleca skonfigurowanie alertów dla zamrożonych klatek większych niż 1% i skonfigurowanie alertów dla wolnych klatek przekraczających 5%. Przekonasz się, że te wartości są obecne jako ustawienia domyślne podczas konfiguracji alertu dotyczącego wydajności. Aby dowiedzieć się więcej o nadmiernie spowolnionych lub zawieszonych klatkach i innych sprawdzonych metodach działania aplikacji, zapoznaj się ze wskazówkami Google Play .