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 alertów niestandardowych 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 do niestandardowych kanałów powiadomień

  Możesz używać Cloud Functions do wysyłania domyślnych Crashlytics alertów do niestandardowych kanałów powiadomień.

---

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

Firebase oferuje domyślne Crashlytics alerty (zobacz stronę z omówieniem alertów). Te domyślne alerty i ich kanały powiadomień mogą jednak nie wystarczyć.

W takich przypadkach możesz używać Cloud Monitoring do wysyłania alertów niestandardowych do niestandardowych kanałów powiadomień na podstawie danych Crashlytics (i opcjonalnie danych sesji Firebase) wyeksportowanych do Cloud Logging.

Aby używać Cloud Monitoring do obsługi alertów niestandardowych, musisz skonfigurować zasadę tworzenia alertów, która określa, w jakich okolicznościach chcesz otrzymywać alerty i w jaki sposób chcesz być o nich powiadamiany.

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ć dostosowaną wiadomość z alertem na określony adres e-mail lub opublikować ją 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 bezpośrednie do Firebase konsoli lub informacje o rozwiązywaniu problemów specyficzne dla firmy.

W dokumentacji Google Cloud dowiesz się więcej o Cloud Monitoring i alertach, w tym o cenach.

Wymagania wstępne

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

2. Skonfiguruj eksport danych Crashlytics i (opcjonalnie) danych sesji Firebase do Cloud Logging.

3. Skonfiguruj kanały powiadomień.

Konfigurowanie zasady tworzenia alertów

Poniżej znajdziesz ogólne instrukcje. Szczegółowe instrukcje znajdziesz w Google Cloud dokumentacji (np. w artykule Tworzenie zasad tworzenia alertów na podstawie progu wskaźnika lub Używanie PromQL do tworzenia zasad tworzenia alertów).

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 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 przycisk Dodaj alert.

  3. Aby dodać alert oparty na SQL, 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 konsoli Google Cloud. Możesz wybrać jedną z tych opcji:

• Kreator: interfejs konsoli zawiera instrukcje tworzenia 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 dane oparte na logach wyeksportowane z Crashlytics i sesji Firebase:

  • Dane o nazwie firebase/crashlytics_events z etykietą errorType, zdefiniowane jako:

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

  • Dane o nazwie firebase/session_events z etykietą eventType, zdefiniowane jako:

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

  Oto przykładowe zapytanie PromQL, które używa tych danych opartych na logach do wysyłania alertu, gdy współczynnik bezawaryjności 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 Crashlytics alertów do niestandardowych kanałów powiadomień

Firebase oferuje domyślne Crashlytics alerty (zobacz listę na stronie z omówieniem opcji alertów). Informacje w tych domyślnych alertach i ich kanałach powiadomień mogą jednak nie wystarczyć.

W takich przypadkach możesz używać Cloud Functions for Firebase do wysyłania tych domyślnych Crashlytics alertów do niestandardowych kanałów powiadomień. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu dotyczące szybkości i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack czy Jira.

Dzięki temu zaawansowanemu mechanizmowi alertów możesz też dostosować 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 konsoli Firebase lub informacje o rozwiązywaniu problemów specyficzne dla firmy.

**Uwaga:** aby korzystać z zaawansowanych funkcji alertów, Twój projekt w Firebase musi korzystać z abonamentu Blaze.

Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase:

1. Skonfiguruj Cloud Functions dla Firebase, co obejmuje następujące 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 Crashlytics i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).

Więcej informacji o wszystkich zdarzeniach alertów Crashlytics, które możesz przechwytywać, znajdziesz w dokumentacji referencyjnej alertów Crashlytics.

Więcej informacji o obsłudze Crashlytics alertów za pomocą Cloud Functions for Firebase