Konfigurowanie zaawansowanych alertów na niestandardowych kanałach powiadomień

Firebase oferuje 2 opcje konfigurowania alertów i wysyłania ich do niestandardowych kanałów powiadomień.

• (Zalecane) Konfigurowanie i wysyłanie niestandardowych alertów do niestandardowych kanałów powiadomień

  Możesz używać Cloud Monitoring do wysyłania w pełni dostosowanych alertów do niestandardowych kanałów powiadomień na podstawie danych Crashlytics i (opcjonalnie) danych sesji Firebase wyeksportowanych do Cloud Logging.

• Wysyłanie domyślnych alertów Crashlytics na niestandardowe kanały powiadomień

  Możesz używać Cloud Functions do wysyłania domyślnych Crashlyticsalertów na niestandardowe kanały powiadomień.

---

(Zalecane) Konfigurowanie i wysyłanie niestandardowych alertów do niestandardowych kanałów powiadomień

Firebase oferuje domyślne Crashlyticsalerty (więcej informacji znajdziesz na stronie z omówieniem alertów). Jednak te domyślne alerty i ich kanały powiadomień mogą nie być wystarczające.

W takich przypadkach możesz użyć Cloud Monitoring, aby wysyłać alerty niestandardowe do niestandardowych kanałów powiadomień na podstawie danych Crashlytics (i opcjonalnie danych sesji Firebase) wyeksportowanych do Cloud Logging.

Aby używać Cloud Monitoring w przypadku alertów niestandardowych, skonfiguruj zasadę tworzenia alertów, która opisuje okoliczności, w których chcesz otrzymywać alerty, oraz sposób powiadamiania.

Jeśli na przykład współczynnik liczby użytkowników bez awarii spadnie poniżej określonego progu,Cloud Monitoring może wysłać dostosowany alert na konkretny adres e-mail lub opublikować go w usłudze innej firmy, takiej jak Discord, Slack czy Jira. Możesz też w pełni dostosować informacje wysyłane w alercie, np. dodać przydatne linki do Firebase lub informacje o rozwiązywaniu problemów specyficzne dla Twojej firmy.

Więcej informacji o Cloud Monitoring i alertach, w tym o cenach, znajdziesz w Google Clouddokumentacji.

Wymagania wstępne

1. Upewnij się, że Twój projekt Firebase korzysta z abonamentu Blaze z płatnością według wykorzystania.

2. Skonfiguruj eksportowanie do Cloud Logging danych Crashlytics i (opcjonalnie) danych o sesjach w Firebase.

3. Skonfiguruj kanały powiadomień.

Konfigurowanie zasady tworzenia alertów

Poniżej znajdziesz ogólne instrukcje. Szczegółowe instrukcje znajdziesz w dokumentacjiGoogle Cloud (np. w artykułach Tworzenie zasad tworzenia alertów na podstawie progów wskaźników lub Tworzenie zasad tworzenia alertów za pomocą PromQL).

W ramach wykonywania zapytań możesz skonfigurować alert oparty na logach lub alert oparty na SQL:

• Skonfiguruj alert oparty na logach:

  1. Uruchom zapytanie w Logs Explorer.

  2. Kliknij wyświetlony przycisk Dodaj alert.

  3. Aby dodać alert oparty na logach, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

• Skonfiguruj alert oparty na SQL:

  1. Uruchom zapytanie w Analizie logów.

  2. Kliknij wyświetlony przycisk Dodaj alert.

  3. Aby dodać alert oparty na SQL-u, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Możesz też skonfigurować alerty dotyczące danych opartych na logach za pomocą narzędzia do konfigurowania zasad w Google Cloud konsoli. Możesz wybrać jedną z tych opcji:

• Kreator: interfejs konsoli udostępnia szczegółowy przepływ pracy, który pomaga utworzyć zasady tworzenia alertów.

• PromQL: podajesz zapytanie PromQL dla zasady tworzenia alertów.

  Przykładowe zapytanie PromQL

  Załóżmy na przykład, że masz 2 wskaźniki oparte na logach dotyczące wyeksportowanych Crashlytics i sesji w Firebase:

  • Rodzaj danych o nazwie firebase/crashlytics_events z etykietą errorType, zdefiniowany w ten sposób:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Inny rodzaj danych o nazwie firebase/session_events z etykietą eventType, zdefiniowany w ten sposób:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Oto przykładowe zapytanie PromQL, które korzysta z tych danych opartych na logach, aby wysyłać alerty, gdy odsetek sesji bez awarii spadnie poniżej 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7

---

Wysyłanie domyślnych alertów Crashlytics do niestandardowych kanałów powiadomień

Firebase oferuje domyślne alerty Crashlytics (zobacz listę na stronie przeglądu opcji alertów). Informacje w tych domyślnych alertach i ich kanałach powiadomień mogą jednak nie być wystarczające.

W takich przypadkach możesz użyć Cloud Functions for Firebase, aby wysyłać domyślne alerty Crashlytics do niestandardowych kanałów powiadomień. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu dotyczące alertów o prędkości  i przesyła informacje o alercie do usługi innej firmy, takiej jak Discord, Slack lub Jira.

Dzięki temu zaawansowanemu mechanizmowi alertów możesz też dostosowywać informacje wysyłane do usługi innej firmy. Oprócz domyślnych informacji dostarczanych przez Firebase możesz na przykład dodać przydatne linki bezpośrednie do Firebase konsoli lub informacje o rozwiązywaniu problemów specyficzne dla firmy.

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

Aby dowiedzieć się więcej o wszystkich Crashlyticszdarzeniach alertów, które możesz rejestrować, zapoznaj się z dokumentacją referencyjną dotyczącą Crashlyticsalertów.

Dowiedz się więcej o obsłudze alertów Crashlytics za pomocą Cloud Functions for Firebase