Dostosowywanie alertów o rosnącej liczbie problemów

Używaj alertów o rosnącej liczbie problemów, aby powiadamiać zespół, gdy określony problem w aplikacji wymaga pilnej reakcji. W przypadku Crashlytics problem to grupa podobnych awarii lub zdarzeń związanych z zawieszaniem się aplikacji (ANR).

Co wywołuje alert?

Alerty o rosnącej liczbie problemów są wywoływane, gdy problem w aplikacji przekroczy określone progi, które możesz skonfigurować w Firebase konsoli.

Próg alertów o szybkości zmian określasz w procentach użytkowników i minimalnej liczbie użytkowników, na których wpłynęła awaria lub błąd ANR. Wartość progu procentowego możesz ustawić w zakresie od 0% do 100% sesji. Minimalny próg liczby użytkowników można ustawić na dowolną liczbę większą lub równą 10. Domyślny próg alertu o szybkości zmian to 1% sesji i 25 użytkowników.

Alert jest wywoływany, jeśli w ciągu 30 minut wszystkie te warunki są spełnione:

  • Problem w aplikacji przekracza określony próg procentowy i minimalną liczbę użytkowników ustawioną dla tej aplikacji.
  • Aplikacja ma w tym okresie co najmniej 10 użytkowników.
  • W przypadku tej wersji aplikacji nie było wcześniej alertu dotyczącego tego problemu.

Konfigurowanie progów alertów o rosnącej liczbie problemów

Aby skonfigurować progi alertów o rosnącej liczbie problemów, musisz mieć uprawnienie firebasecrashlytics.config.update. Te uprawnienia są domyślnie uwzględnione w tych rolach: Administrator Firebase Crashlytics, Administrator jakości w Firebase, Administrator Firebase oraz Właściciel lub Edytujący projektu.

Skonfiguruj progi alertów o rosnącej liczbie problemów dla każdej zarejestrowanej aplikacji. Każda aplikacja może mieć inny próg alertu.

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu. Wybierz kartę Alerty.

  3. Otwórz kartę alertów Crashlytics i wybierz kartę Alerty dotyczące szybkości.

  4. Skonfiguruj progi alertów dla aplikacji.

Otrzymywanie alertów

Otrzymywanie domyślnych alertów

Domyślnie Firebase może wysyłać Crashlytics alerty e-mailem. W przypadku alertów o szybkości zmian i regresji Firebase może też wyświetlać te alerty w Firebasekonsoli.

Aby otrzymywać alerty Crashlytics za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie firebase.projects.update. To wymagane uprawnienie jest domyślnie zawarte w tych rolach: Administrator Firebase oraz Właściciel lub Edytujący projektu.

Domyślnie każdy użytkownik projektu (który ma wymagane uprawnienia do otrzymywania alertów) będzie otrzymywać e-maila, gdy zostanie uruchomiony alert z Crashlytics.

Włączanie i wyłączanie alertów na własnym koncie

Na własnym koncie możesz włączać i wyłączać Crashlyticsalerty bez wpływu na innych członków projektu. Pamiętaj, że nadal potrzebujesz wymaganych uprawnień, aby otrzymywać alerty.

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu. Wybierz kartę Alerty.

  3. Otwórz kartę alertów Crashlytics i wybierz kartę Alerty dotyczące szybkości.

  4. Ustaw preferencje konta dotyczące alertów Crashlytics.

Konfigurowanie podstawowych alertów dotyczących usług innych firm

W przypadku alertów Crashlytics Firebase oferuje mechanizm wysyłania alertów do tych usług innych firm: Slack, JiraPagerDuty.

  1. Skonfiguruj te podstawowe opcje alertów, korzystając z procesów z instrukcjami na karcie Integracje ustawieniach projektu.

  2. Wybierz konfigurację, która będzie używana w przypadku poszczególnych aplikacji, i skonfiguruj miejsce docelowe innych alertów na karcie Crashlytics Alerty ustawieniach projektu.

Jeśli chcesz mieć większą kontrolę nad wysyłaniem alertów do dowolnej usługi innej firmy (nie tylko Slack, Jira czy PagerDuty) i dostosowywać je, zapoznaj się z sekcją Konfigurowanie zaawansowanych alertów dla usług innych firm, w której opisujemy zaawansowane opcje alertów.

Konfigurowanie zaawansowanych alertów w usługach innych firm

Możesz wysyłać Crashlytics 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 alertów o rozwijających się problemach i przesyła informacje o alercie do usługi innej firmy, takiej jak Discord, Slack czy Jira. Dzięki temu zaawansowanemu mechanizmowi alertów możesz w pełni dostosować informacje wysyłane do usługi zewnętrznej. Możesz na przykład dodać przydatne linki bezpośrednie do konsoli Firebase lub informacje o rozwiązywaniu problemów specyficzne dla Twojej firmy.

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

  1. Skonfiguruj Cloud Functions dla Firebase, wykonując te czynności:

    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 wdroż funkcję, która przechwytuje zdarzenie alertu z Crashlytics i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).

Wszystkie Crashlyticszdarzenia alertów, które możesz rejestrować, znajdziesz w dokumentacji referencyjnej dotyczącej Crashlyticsalertów.