Konfigurowanie alertów dotyczących problemów z wydajnością

Używaj alertów Performance Monitoring, aby powiadamiać członków zespołu, 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 wydajność zdarzenia przekroczy ustawiony próg.

Co powoduje wywołanie alertu?

Alert jest wywoływany, gdy wartość danych aplikacji przekroczy próg zdefiniowany w Konsoli Firebase dla określonego percentyla (jeśli dotyczy). Alerty są wywoływane tylko wtedy, gdy aplikacja korzysta z wersji pakietu SDK zgodnej z czasem rzeczywistym.

Więcej informacji 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 danych wydajności lub integracji skonfigurowanych w Konsoli Firebase ze Slackiem, Jirą lub PagerDuty nie są dostępne w przypadku Performance Monitoring alertów.

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ć uprawnienie firebaseperformance.config.update. Domyślnie to wymagane uprawnienie jest dostępne w tych rolach:

• Administrator usługi Monitorowanie wydajności Firebase
• Administrator jakości Firebase
• Administrator Firebase
• Właściciel lub edytor projektu

Alerty i ich ustawienia dotyczą całego projektu. Oznacza to, że domyślnie każdy członek zespołu otrzyma e-maila, gdy zostanie wywołany alert dotyczący wydajności. Alerty są wysyłane tylko do członków zespołu, którzy mają wymagane uprawnienia do ich otrzymywania oraz na indywidualne adresy e-mail (nie do grup kont, takich jak grupy 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ć Performance Monitoring alerty bez wpływu na innych członków zespołu. Pamiętaj, że nadal musisz mieć wymagane uprawnienia do otrzymywania alertów.

Aby włączyć lub wyłączyć alerty Performance Monitoring:

1. W konsoli Firebase w prawym górnym rogu kliknij notifications Alerty Firebase.
2. Następnie kliknij kolejno settings 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 Monitoring alerty 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 dotyczące powolnego uruchamiania 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:

1. Skonfiguruj Cloud Functions dla Firebase, co obejmuje te zadania:

   1. Skonfiguruj środowisko programistyczne dla Node.js lub Pythona.
   2. Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.
   3. Zainicjuj Cloud Functions for Firebase za pomocą interfejsu wiersza poleceń Firebase.

2. Napisz i wdróż funkcję, która przechwytuje zdarzenie alertu z usługi 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 przechwytywać, zapoznaj się z dokumentacją referencyjną alertów usługi Monitorowanie wydajności.

Automatyczne usuwanie nieprawidłowych alertów

Performance Monitoring sprawdza alerty, aby upewnić się, ż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 został utworzony dla identyfikatora zasobu, dla którego 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 dla 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 Agregowanie danych według niestandardowych wzorców adresów URL.

Jeśli żaden z tych warunków nie jest spełniony, Performance Monitoring usuwa alert.

Konfigurowanie alertu

Aby skonfigurować alerty Performance Monitoring, musisz mieć uprawnienie firebaseperformance.config.update. Domyślnie to wymagane uprawnienie jest dostępne w tych rolach: Administrator usługi Monitorowanie wydajności Firebase, Administrator jakości Firebase, Administrator Firebase, oraz Właściciel lub edytor projektu.

Jeśli jeszcze tego nie zrobisz, dodaj do aplikacji najnowszą wersję pakietu SDK Performance Monitoring. Więcej informacji znajdziesz w przewodnikach dla platform internetowych, Androida, Apple i Fluttera.

W każdej zarejestrowanej aplikacji użyj tabeli Logi czasu 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, z których każdy ma inny próg (lub nie mieć żadnych alertów).

Konfigurowanie alertu w tabeli Logi czasu

1. W Performance Monitoring Panelu w Firebase konsoli wybierz aplikację, dla której chcesz skonfigurować alert.

2. Przewiń w dół do tabeli Logi czasu u dołu ekranu.

3. Wybierz kartę typu logu czasu, dla którego chcesz ustawić alert, a następnie znajdź odpowiedni wiersz.

4. Po prawej stronie wiersza otwórz menu przepełnienia (more_vert) i wybierz Ustawienia alertów.

5. 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 aplikacji internetowych. Więcej informacji o domyślnych percentylach znajdziesz w artykule Śledzenie kluczowych danych w panelu.

Konfigurowanie alertu na karcie raportu w panelu

1. W Performance Monitoring Panelu w Firebase konsoli wybierz aplikację, dla której chcesz skonfigurować alert.

2. Na karcie Raport znajdź kartę danych, dla których chcesz skonfigurować alert.

3. Na wybranej karcie danych otwórz menu przepełnienia (more_vert) i wybierz Ustawienia alertów.

4. 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 aplikacji internetowych. Więcej informacji o domyślnych percentylach znajdziesz w artykule Śledzenie kluczowych danych w panelu.

Sprawdzone metody 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ć:

• wzorcami zdefiniowanymi przez użytkownika, czyli niestandardowymi wzorcami adresów URL;

• wzorcami wygenerowanymi przez Firebase, czyli automatycznymi wzorcami adresów URL.
  Te wzorce mogą się zmieniać w czasie w zależności od najnowszych zachowań użytkowników aplikacji.

Konfigurowanie alertów dotyczących niestandardowych wzorców adresów URL

Zalecamy skonfigurowanie alertów dotyczących wszystkich skonfigurowanych niestandardowych wzorców adresów URL. Ponieważ Firebase najpierw próbuje dopasować żądanie do niestandardowego wzorca adresu URL, 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 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 adresów URL

Podczas konfigurowania alertu dotyczącego automatycznego wzorca adresu URL upewnij się, że ten wzorzec jest stabilny od kilku dni. Pamiętaj, że automatyczne wzorce adresów URL mogą się zmieniać w czasie, a konfiguracje alertów nie są przenoszone na nowe wzorce adresów URL. Może to spowodować nieprawidłowe lub brakujące alerty dotyczące wzorców, które Cię interesują. Możesz też utworzyć niestandardowy wzorzec adresu URL, aby zapewnić jego stabilność.

Wczytanie strony internetowej

Zalecane progi pomiaru danych internetowych znajdziesz w dokumentacji dotyczącej podstawowych wskaźników internetowych.

Renderowanie ekranu

Aby zapewnić optymalne działanie aplikacji, sesje użytkowników nie powinny zawierać spowolnionych ani zablokowanych klatek. Performance Monitoring zaleca skonfigurowanie alertów dotyczących zablokowanych klatek , których liczba przekracza 1%, oraz alertów dotyczących spowolnionych klatek, których liczba przekracza 5%. Te wartości są domyślnie ustawione podczas konfigurowania alertu dotyczącego wydajności. Więcej informacji o nadmiernej liczbie spowolnionych lub zablokowanych klatek oraz innych sprawdzonych metodach zwiększania wydajności aplikacji znajdziesz w wytycznych Google Play.