Skonfiguruj alerty dotyczące problemów z wydajnością

Użyj alertów monitorowania wydajności, aby powiadomić członków projektu, jeśli zmiany w kodzie lub żądania sieciowe spowodują obniżenie wydajności Twojej aplikacji.

Możesz skonfigurować i dostosować alerty dla swojej aplikacji, które będą powiadamiać Cię, gdy wydajność zdarzenia przekroczy ustalony próg.

Co wyzwala alert?

Alert jest wyzwalany, gdy metryka Twojej aplikacji przekracza próg zdefiniowany dla określonego percentyla (jeśli ma to zastosowanie) w konsoli Firebase. Alerty są wyzwalane tylko wtedy, gdy Twoja aplikacja korzysta z wersji SDK zgodnej z czasem rzeczywistym .

czas rozpoczęcia aplikacji

Po skonfigurowaniu alertu dotyczącego czasu uruchomienia aplikacji alert zostanie wywołany, jeśli zostaną spełnione wszystkie poniższe warunki:

  • Firebase zarejestrowało w ciągu ostatniej godziny co najmniej 100 próbek śledzenia _app_start dla najnowszej wersji Twojej aplikacji.
  • Czas trwania śledzenia _app_start przekroczył próg zdefiniowany dla aplikacji w ciągu ostatniej godziny i dla skonfigurowanego percentyla.
  • W najnowszej wersji Twojej aplikacji nie zgłoszono wcześniej żadnego alertu dla tego samego progu.

niestandardowe ślady kodu

Po skonfigurowaniu alertu dla niestandardowej metryki śledzenia kodu alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:

  • Firebase zarejestrowało w ciągu ostatniej godziny co najmniej 100 próbek niestandardowego kodu śledzenia 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 dla tego samego progu.
  • (Tylko dla Internetu) W ciągu ostatnich 3 dni nie został wcześniej zgłoszony żaden alert dla tego samego progu .

żądania sieciowe

Po skonfigurowaniu alertu dla metryki żądań sieciowych alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:

  • W ciągu ostatniej godziny Firebase zarejestrowało co najmniej 100 próbek pasujących do wzorca adresu URL we wszystkich wersjach Twojej aplikacji.
  • Zagregowana wartość metryki przekroczyła zdefiniowany 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 u wszystkich użytkowników
  • W ciągu ostatnich 3 dni nie zgłoszono wcześniej żadnego alertu dla tego samego progu.

renderowanie ekranu

Po skonfigurowaniu alertu dla metryki renderowania ekranu alert zostanie wywołany, jeśli zostaną spełnione wszystkie poniższe warunki:

  • Firebase zarejestrowało w ciągu ostatniej godziny co najmniej 100 próbek renderowania ekranu dla najnowszej wersji Twojej aplikacji.
  • Zagregowana wartość metryki przekroczyła zdefiniowany próg w ciągu ostatniej godziny:
    • klatki zamrożone : zagregowana wartość przekroczyła ustawiony próg
    • wolne klatki : zagregowana wartość przekroczyła ustawiony próg
  • W najnowszej wersji Twojej aplikacji nie zgłoszono wcześniej żadnego alertu dla tego samego progu.

strona się ładuje

Po skonfigurowaniu alertu dotyczącego metryki ładowania strony alert zostanie wywołany, jeśli zostaną spełnione wszystkie poniższe warunki:

  • Firebase zarejestrowało co najmniej 100 próbek ładowania 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 treściwa farba : 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 najlepszych praktykach konfigurowania alertów dla określonych typów śladów i metryk.

Alerty dotyczące innych wskaźników wydajności lub wbudowanych integracji Firebase z Slack , Jira i PagerDuty nie są dostępne w przypadku alertów monitorowania wydajności.

Otrzymuj powiadomienia

Otrzymuj domyślne alerty

Domyślnie Firebase może wysyłać alerty dotyczące monitorowania wydajności pocztą elektroniczną.

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:

Alerty i ich ustawienia dotyczą całego projektu. Oznacza to, że domyślnie każdy członek projektu (niebędący grupą e-mailową i posiadający wymagane uprawnienia do otrzymywania alertów) otrzyma wiadomość e-mail w przypadku wyzwolenia 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:

  1. W konsoli Firebase w prawym górnym rogu przejdź do Alerty Firebase .
  2. Następnie idź do Ustawienia i ustaw preferencje konta dotyczące alertów monitorowania wydajności.

Skonfiguruj zaawansowane alerty dla usług innych firm

Możesz także wysyłać alerty monitorowania wydajności do preferowanego kanału powiadomień swojego zespołu, korzystając z Cloud Functions dla Firebase. Można 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 lub Jira.

Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions dla Firebase, wykonaj następujące kroki:

  1. Skonfiguruj Cloud Functions dla Firebase , co obejmuje następujące zadania:

    1. Skonfiguruj środowisko programistyczne dla Node.js lub Python.
    2. Zainstaluj i zaloguj się w interfejsie CLI Firebase.
    3. Zainicjuj funkcje chmury dla Firebase za pomocą interfejsu wiersza polecenia Firebase.
  2. 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 związanych z alertami wydajnościowymi, które można przechwycić, zapoznaj się z dokumentacją referencyjną dotyczącą alertów monitorowania wydajności .

Automatyczne usuwanie nieprawidłowych alertów

Monitorowanie wydajności sprawdza alerty, aby upewnić się, że dane są prawidłowe i że alerty są aktywnie używane. Alerty uważa się 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 dotyczących tego wzorca. Jeśli w ciągu 90 dni nie zostaną przesłane żadne dane, monitorowanie wydajności usunie ten alert. Aby uzyskać więcej informacji na temat niestandardowych wzorców adresów URL, zobacz Agregowanie danych w obszarze wzorców adresów URL klientów .

Jeśli którykolwiek z tych warunków nie zostanie spełniony, Monitorowanie wydajności usunie alert.

Skonfiguruj alert

Aby skonfigurować alerty monitorowania wydajności, 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 oraz Właściciel lub redaktor projektu.

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 zarejestrowanej aplikacji użyj tabeli Traces lub karty raportu Panel kontrolny, 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 może nie mieć żadnych alertów).

Skonfiguruj alert w tabeli Traces

  1. Przejdź do zakładki Performance Monitoring Dashboard w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.

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

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

  4. Po prawej stronie wiersza otwórz rozszerzone menu ( ) 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. dla Androida i iOS oraz 75. dla Internetu. Aby dowiedzieć się więcej o domyślnych percentylach, zobacz Śledzenie kluczowych wskaźników na pulpicie nawigacyjnym .

Skonfiguruj alert na karcie raportu Panelu

  1. Przejdź do zakładki Performance Monitoring Dashboard w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.

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

  3. Na wybranej karcie metrycznej otwórz menu rozszerzone ( ) 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. dla Androida i iOS oraz 75. dla Internetu. Aby dowiedzieć się więcej o domyślnych percentylach, zobacz Śledzenie kluczowych wskaźników na pulpicie nawigacyjnym .

Najlepsze praktyki dotyczące ustawiania alertu dotyczącego wydajności

Żądania sieciowe

Firebase agreguje dane z podobnych żądań sieciowych w ramach wzorców adresów URL, które mogą mieć jedną z następujących cech:

Skonfiguruj alerty dla niestandardowych wzorców adresów URL

Zalecamy skonfigurowanie alertów dla wszelkich 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 będą 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 automatyczny wzorzec adresu URL ustabilizował się przez kilka dni. Należy pamiętać, że automatyczne wzorce adresów URL mogą z czasem ulegać zmianom, a konfiguracje alertów nie mają zastosowania 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 mieć pewność, że ten wzorzec będzie stabilny.

Strona internetowa się ładuje

Aby poznać zalecane progi pomiaru wskaźników internetowych, zapoznaj się z dokumentacją Core Web Vitals .

Renderowania ekranu

Aby zapewnić optymalne działanie aplikacji, sesje użytkowników nie powinny powodować wolnych i zawieszonych klatek. Monitorowanie wydajności zaleca skonfigurowanie alertów w przypadku zamrożonych klatek przekraczających 1% i skonfigurowanie alertów w przypadku wolnych klatek przekraczających 5%. Przekonasz się, że te wartości są obecne jako ustawienia domyślne podczas konfiguracji alertu wydajności. Aby dowiedzieć się więcej o nadmiernie wolnych lub zawieszonych klatkach i innych sprawdzonych metodach dotyczących wydajności aplikacji, zapoznaj się ze wskazówkami Google Play .