Check out what’s new from Firebase at Google I/O 2022. Learn more

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 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 ma to zastosowanie) w konsoli Firebase. Alerty są wyzwalane tylko wtedy, gdy Twoja aplikacja korzysta z wersji SDK zgodnej w czasie rzeczywistym .

czas uruchomienia aplikacji

Gdy skonfigurujesz alert dotyczący czasu uruchomienia aplikacji, alert zostanie wyzwolony, jeśli spełnione są wszystkie następujące warunki:

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

niestandardowe ślady kodu

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

  • Firebase zarejestrowało co najmniej 100 próbek niestandardowego śledzenia kodu dla najnowszej wersji Twojej aplikacji w ciągu ostatniej godziny.
  • Czas trwania śledzenia przekroczył zdefiniowany próg aplikacji w ciągu ostatniej godziny i dla skonfigurowanego percentyla.
  • (Tylko dla systemów iOS+ i Android) W najnowszej wersji aplikacji nie było wcześniej zgłoszonych alertów dotyczących tego samego progu.
  • (Tylko w internecie) W ciągu ostatnich 3 dni nie zgłoszono żadnego alertu dotyczącego tego samego progu .

żądania sieciowe

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

  • Firebase zarejestrował co najmniej 100 próbek pasujących do wzorca adresu URL we wszystkich wersjach Twojej aplikacji w ciągu ostatniej godziny.
  • 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+/Android) zagregowana wartość spadła poniżej ustawionego progu dla wszystkich użytkowników
  • W ciągu ostatnich 3 dni nie zgłoszono żadnego alertu dotyczącego tego samego progu .

renderowanie ekranu

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

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

ładuje się strona

Po skonfigurowaniu alertu dla wskaźnika ładowania strony alert jest wyzwalany, jeśli spełnione są wszystkie następujące warunki:

  • Firebase zarejestrował co najmniej 100 próbek wczytywania strony Twojej aplikacji w ciągu ostatniej godziny.
  • Zagregowana wartość wskaźnika 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 zawartość treściowa : łączna wartość przekroczyła ustawiony próg i skonfigurowany percentyl
    • pierwsza farba : łączna wartość przekroczyła ustawiony próg i skonfigurowany percentyl
  • W ciągu ostatnich 3 dni nie zgłoszono żadnego alertu dotyczącego 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 śladów i metryk.

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

Otrzymuj alerty

Alerty monitorowania wydajności są wysyłane za pośrednictwem powiadomień e-mail.

Aby otrzymywać alerty monitorowania wydajności, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie zawierają to wymagane uprawnienie:

Alerty i ich ustawienia dotyczą całego projektu. Oznacza to, że domyślnie każdy członek projektu (posiadający wymagane uprawnienia do otrzymywania alertów) otrzyma powiadomienie e-mail po uruchomieniu alertu.

Monitorowanie wydajności sprawdza poprawność alertów, aby upewnić się, że dane są prawidłowe i że alerty są aktywnie używane. Alerty są uznawane za ważne, jeśli spełniony jest jeden z poniższych warunków:

  • Alert jest tworzony dla identyfikatora zasobu, dla którego Performance Monitoring otrzymał 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 w ciągu 90 dni nie zostaną wysłane żadne dane, funkcja monitorowania wydajności usuwa ten alert. Aby uzyskać więcej informacji o niestandardowych wzorcach adresów URL, zobacz Agregowanie danych we wzorcach adresów URL klientów .

Jeśli którykolwiek z tych warunków nie jest spełniony, monitorowanie wydajności usuwa alert.

Włącz/wyłącz alerty na swoim koncie

Na własnym koncie możesz włączyć/wyłączyć alerty monitorowania wydajności bez wpływu na innych członków projektu. Pamiętaj, że nadal potrzebujesz wymaganych uprawnień, aby otrzymywać alerty.

W konsoli Firebase w prawym górnym rogu przejdź do Alerty Firebase > Ustawienia , a następnie ustaw preferencje konta dla alertów monitorowania wydajności.

Skonfiguruj alert

Aby skonfigurować alerty monitorowania wydajności, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie zawierają to wymagane uprawnienie: Administrator wydajności Firebase , Administrator jakości Firebase , Administrator Firebase oraz Właściciel lub edytujący projekt .

Jeśli jeszcze tego nie zrobiłeś, dodaj do swojej aplikacji najnowszy pakiet SDK monitorowania wydajności. 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 Ślady 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 Traces

  1. Przejdź do zakładki Panel monitorowania wydajności 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 Menu przepełnienia ( ) 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 Panel monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować alert.

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

  3. Na żądanej karcie metrycznej otwórz Menu przepełnienia ( ) 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 wydajności

Żądania sieciowe

Firebase agreguje dane z podobnych żądań sieciowych według wzorców adresów URL, które mogą być jednym z tych:

Skonfiguruj alerty dla niestandardowych wzorców adresów URL

Zalecamy skonfigurowanie alertów dla wszystkich 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 adresu URL będą bardziej zrozumiałe i skuteczne dla Twojego zespołu, ponieważ ten konkretny wzorzec żądań został już przez Ciebie określony 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. 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 też rozważyć utworzenie niestandardowego wzorca adresu URL, aby zapewnić jego stabilność.

Ładowanie strony internetowej

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

Rendery ekranu

Aby zapewnić optymalne działanie aplikacji, sesje użytkowników powinny być wolne od powolnych i zamrożonych ramek. Performance Monitoring zaleca skonfigurowanie alertów dla zamrożonych ramek większych niż 1% i skonfigurowanie alertów dla wolnych ramek przekraczających 5%. Przekonasz się, że te wartości są obecne jako ustawienia domyślne podczas konfiguracji alertów wydajności. Aby dowiedzieć się więcej o nadmiernie powolnych lub zawieszonych klatkach oraz innych sprawdzonych metodach dotyczących wydajności aplikacji, zapoznaj się ze wskazówkami Google Play .