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 alertów niestandardowych 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żyć Cloud Functions, aby wysyłać domyślne alerty Crashlytics do niestandardowych kanałów powiadomień.

---

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

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

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

Aby używać Cloud Monitoring do 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ć alert niestandardowy na określony 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 ramach alertu, np. dołączyć przydatne precyzyjne linki do konsoli Firebase lub informacje o rozwiązywaniu problemów dotyczące konkretnej firmy.

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

Wymagania wstępne

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

2. Skonfiguruj eksport danych Crashlytics i (opcjonalnie) danych o sesjach 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 dokumentacji Google Cloud (np. Tworzenie zasad tworzenia alertów dotyczących 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 wskaźników opartych na logach za pomocą narzędzia do konfiguracji zasad w konsoli Google Cloud, gdzie możesz wybrać jedną z tych opcji:

• Kreator: interfejs konsoli udostępnia szczegółowy przepływ pracy, który umożliwia utworzenie zasady tworzenia alertów.

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

  Przykładowe zapytanie PromQL

  Załóżmy na przykład, że masz utworzone 2 wskaźniki oparte na logach dla wyeksportowanych danych sesji Crashlytics i Firebase:

  • 1 rodzaj danych o nazwie firebase/crashlytics_events z etykietą errorType, który jest zdefiniowany jako:

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

  • Inny rodzaj danych o nazwie firebase/session_events z etykietą eventType, który jest zdefiniowany jako:

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

  Oto przykładowe zapytanie PromQL, które używa tych wskaźników opartych na logach do wysyłania alertów, 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 udostępnia domyślne alerty Crashlytics (zobacz listę na stronie przeglądu opcji alertów). Informacje zawarte w tych domyślnych alertach i ich kanałach powiadomień mogą jednak nie wystarczyć do Twoich potrzeb.

W takich przypadkach możesz użyć Cloud Functions for Firebase, aby wysyłać te 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 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ż dostosowywać informacje wysyłane do usługi innej firmy. Na przykład oprócz domyślnych informacji dostarczanych przez Firebase możesz też dołączyć przydatne precyzyjne linki do konsoli Firebase lub informacje o rozwiązywaniu problemów dotyczące konkretnej 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. skonfigurować ś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).

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

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