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

Używaj alertów Performance Monitoring, aby powiadamiać członków projektu, jeśli zmiany w kodzie lub żądania sieciowe pogarszają wydajność aplikacji.

Możesz skonfigurować i dostosowywać alerty dotyczące aplikacji, które będą Cię powiadamiać, gdy wydajność danego zdarzenia przekroczy ustawiony próg.

Co powoduje wyświetlenie alertu?

Alert jest aktywowany, gdy dane dotyczące Twojej aplikacji przekroczą próg określony przez Ciebie w konsoli Firebase dla określonego odsetka (w stosownych przypadkach). Alerty są wywoływane tylko wtedy, gdy aplikacja używa wersji pakietu SDK zgodnej z czasem rzeczywistym.

Czas rozpoczęcia działania aplikacji

Gdy skonfigurujesz alert dotyczący czasu uruchamiania aplikacji, alert zostanie uruchomiony, jeśli spełnione są wszystkie te warunki:

  • W ciągu ostatniej godziny Firebase zarejestrował co najmniej 100 próbek _app_start w przypadku najnowszej wersji aplikacji.
  • Czas trwania _app_start przekroczył określony przez aplikację próg w ciągu ostatniej godziny i dla skonfigurowanego percentyla.
  • W najnowszej wersji aplikacji nie było wcześniej żadnego ostrzeżenia dotyczącego tego samego progu.

śledzenia kodu niestandardowego,

Gdy skonfigurujesz alert dla danych ścieżki kodu niestandardowego, zostanie on uruchomiony, jeśli wszystkie te warunki są spełnione:

  • Firebase zarejestrowała w ciągu ostatniej godziny co najmniej 100 próbek śladu kodu niestandardowego w najnowszej wersji aplikacji.
  • Czas trwania ścieżki przekroczył określony przez aplikację próg w ciągu ostatniej godziny i w przypadku skonfigurowanego percentyla.
  • (Dotyczy tylko iOS + i Androida) w najnowszej wersji aplikacji nie było wcześniej żadnego alertu dotyczącego tego samego progu.
  • (Dotyczy tylko wersji sieciowej) w ciągu ostatnich 3 dni nie został wysłany alert dotyczący tego samego progu.

żądania sieciowe

Gdy skonfigurujesz alert dla wskaźnika żądań sieci, alert zostanie uruchomiony, jeśli spełnione są wszystkie te warunki:

  • W ciągu ostatniej godziny Firebase zarejestrował co najmniej 100 próbek pasujących do wzorca adresu URL we wszystkich wersjach Twojej aplikacji.
  • W ciągu ostatniej godziny zsumowana wartość danych przekroczyła określony próg:
    • czas odpowiedzi: zespolone wartości przekroczyły ustawiony próg dla skonfigurowanego centyla.
    • wskaźnik sukcesu: (dotyczy tylko iOS + i Androida) zsumowana wartość spadła poniżej ustawionego progu dla wszystkich użytkowników;
  • W ciągu ostatnich 3 dni nie został wysłany żaden alert dotyczący tego samego progu.

renderowanie ekranu

Gdy konfigurujesz alert dotyczący danych dotyczących renderowania ekranu, jest on uruchamiany, jeśli są spełnione wszystkie te warunki:

  • W ciągu ostatniej godziny Firebase zarejestrowała co najmniej 100 próbek renderowania ekranu w przypadku najnowszej wersji aplikacji.
  • W ciągu ostatniej godziny zmierzona wartość danych przekroczyła zdefiniowany próg:
    • zablokowane klatki: zsumowana wartość przekroczyła ustawiony próg.
    • spowolnione klatki: zsumowana wartość przekroczyła ustawiony próg.
  • W najnowszej wersji aplikacji nie było wcześniej żadnego ostrzeżenia dotyczącego tego samego progu.

wczytywania strony,

Gdy konfigurujesz alert dotyczący wskaźnika wczytywania strony, alert jest uruchamiany, jeśli są spełnione wszystkie te warunki:

  • W ciągu ostatniej godziny Firebase zarejestrowała co najmniej 100 próbek ładowania strony w Twojej aplikacji.
  • Uśredniona wartość danych przekroczyła określony próg w ciągu ostatniej godziny i dla skonfigurowanego percentyla:
    • opóźnienie przy pierwszym działaniu: zsumowana wartość przekroczyła ustawiony próg i skonfigurowany przedział percentylowy
    • Pierwsze wyrenderowanie treści: zagregowana wartość przekroczyła ustawiony próg i skonfigurowany przedział percentylowy
    • pierwsze wyświetlenie: zespolone wartości przekroczyły ustawiony próg i skonfigurowany przedział percentylowy
  • W ciągu ostatnich 3 dni nie został wysłany żaden alert dotyczący tego samego progu.

Dowiedz się więcej o konfigurowaniu alertów, domyślnych wartości percentylowych oraz sprawdzonych metodach konfigurowania alertów dotyczących określonych typów dziennikó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.

otrzymywać alerty;

Otrzymywanie domyślnych alertów

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ć uprawnienia firebaseperformance.config.update. Wymagane uprawnienia są domyślnie dostępne w przypadku tych ról:

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ą uprawnienia wymagane do otrzymywania alertów, oraz do poszczególnych adresów 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 nadal musisz mieć wymagane uprawnienia, aby otrzymywać alerty.

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

  1. W konsoli Firebase w prawym górnym rogu kliknij Alerty Firebase.
  2. Następnie otwórz Ustawienia i ustaw preferencje 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 rejestruje zdarzenie alertu dotyczące długiego czasu uruchamiania aplikacji i publikuje informacje o nim w usłudze innej firmy, takiej jak Discord, Slack czy Jira.

Aby skonfigurować zaawansowane funkcje tworzenia alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:

  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 Performance Monitoring i obsługuje ładunek tego zdarzenia (np. publikuje informacje o alertach w wiadomości na Discordzie).

Więcej informacji o wszystkich zdarzeniach alertów wydajności, które możesz rejestrować, znajdziesz w dokumentacji referencyjnej dotyczącej alertów Monitorowania wydajności.

Automatyczne usuwanie nieprawidłowych alertów

Performance Monitoring sprawdza alerty pod kątem poprawności danych i aktywnego ich używania. Alerty są uznawane za ważne, jeśli spełniony jest jeden z tych warunków:

  • Alert jest tworzony dla identyfikatora zasobu, który otrzymał dane z usług Performance Monitoring w ciągu ostatnich 90 dni.
  • Alert został niedawno utworzony dla niestandardowego wzorca adresu URL. Po utworzeniu niestandardowego wzoru adresu URL i skonfigurowaniu alertu masz 90 dni na wysyłanie danych dotyczących tego wzoru. Jeśli w ciągu 90 dni nie zostanie wysłane żadne dane, Performance Monitoring usunie ten alert. Więcej informacji o niestandardowych wzorcach adresów URL znajdziesz w sekcji Dane zbiorcze w ramach wzorców adresów URL klientów.

Jeśli którykolwiek 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. Te uprawnienia są domyślnie wymagane w przypadku tych ról: Administrator wydajności Firebase, Administrator jakości w Firebase, Administrator Firebase oraz Właściciel lub Edytujący projekt.

Jeśli jeszcze tego nie zrobiono, dodaj do aplikacji najnowszy pakiet SDK Performance Monitoring. Więcej informacji znajdziesz w przewodnikach wprowadzających na temat sieci, Androida, Apple i Fluttera.

W każdej zarejestrowanej aplikacji użyj tabeli Ścieżek lub karty raportu w panelu informacyjnym, aby skonfigurować alert dla każdego rodzaju danych, które chcesz monitorować. Każda aplikacja może mieć inny zestaw alertów z różnymi wartościami progowymi (lub nie mieć żadnych alertów).

Konfigurowanie alertu w tabeli Ślady

  1. W konsoli Firebase kliknij kartę Performance Monitoring Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.

  2. Przewiń w dół do tabeli Ślady u dołu ekranu.

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

  4. W prawym rogu wiersza otwórz menu przewijania () i wybierz Ustawienia alertów.

  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić dla aplikacji próg alertu i procentyl (jeśli dotyczy), lub włączyć lub wyłączyć alert. Domyślne wartości percentylów to 90. na Androidzie i iOS oraz 75. w internecie. Więcej informacji o domyślnych wartościach percentylowych znajdziesz w artykule Śledzenie kluczowych danych w panelu.

Konfigurowanie alertu na karcie raportu w panelu

  1. W konsoli Firebase kliknij kartę Performance Monitoring Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.

  2. Na karcie Karta raportu znajdź kartę danych, dla której chcesz skonfigurować alert.

  3. Na wybranej karcie danych otwórz menu rozwijane  i kliknij Ustawienia alertów.

  4. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ustawić dla aplikacji próg alertu i procentyl (jeśli dotyczy), lub włączyć lub wyłączyć alert. Domyślne wartości percentylów to 90. na Androidzie i iOS oraz 75. w internecie. Więcej informacji o domyślnych wartościach percentylowych znajdziesz w artykule Śledzenie kluczowych danych w panelu.

Sprawdzone metody konfigurowania alertu dotyczącego skuteczności

Żądania sieciowe

Firebase agreguje dane z podobnych żądań sieciowych według wzorca adresu URL, który może być jednym z tych:

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

Zalecamy skonfigurowanie alertów dla niestandardowych wzorców adresów URL. Firebase najpierw próbuje dopasować żądanie do niestandardowego wzorca adresu URL, dzięki czemu podobne żądania są bardziej konsekwentnie 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ż już wcześniej zidentyfikowałeś ten konkretny wzorzec żądań jako ważny dla aplikacji.

Konfigurowanie alertów dla automatycznych wzorców adresó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ę zmienić z czasem, 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 interesujących Cię wzorców. Możesz też utworzyć niestandardowy wzorzec adresu URL, aby mieć pewność, że jest on stabilny.

Wczytywanie stron internetowych

Aby dowiedzieć się, jakie są zalecane progi pomiaru danych internetowych, zapoznaj się z dokumentacją dotyczącą podstawowych wskaźników internetowych.

Renderowanie ekranu

Aby zapewnić optymalne działanie aplikacji, sesje użytkownika 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ą dostępne jako ustawienia domyślne podczas konfigurowania alertów dotyczących wydajności. Więcej informacji o nadmiernie spowolnionych lub zablokowanych klatkach oraz o sprawdzonych metodach zwiększania skuteczności aplikacji znajdziesz w instrukcjach Google Play.