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 na niestandardowe kanały powiadomień

  Możesz użyć Cloud Functions, aby wysyłać domyślne Crashlyticsalerty na niestandardowe kanały powiadomień.

---

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

Firebase oferuje domyślne Crashlytics alerty (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żywać 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, musisz skonfigurować zasadę tworzenia alertów, która opisuje okoliczności, w których chcesz otrzymywać alerty, oraz sposób powiadamiania.

Jeśli na przykład odsetek sesji 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 do konsoli Firebase lub informacje o rozwiązywaniu problemów dotyczące konkretnej firmy.

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

Wymagania wstępne

1. Sprawdź, czy Twój projekt Firebase korzysta z abonamentu Blaze z płatnością według zużycia zasobów.

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

3. Skonfiguruj kanały powiadomień.

Konfigurowanie zasady tworzenia alertów

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

Podczas 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 rodzajów danych opartych na logach za pomocą narzędzia do konfigurowania zasad w Google Cloud konsoli. Możesz tam wybrać jedną z tych opcji:

• Kreator: interfejs konsoli udostępnia przepływ pracy z instrukcjami, który pomaga utworzyć zasadę alertowania.

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

  Przykładowe zapytanie PromQL

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

  • Jedne dane o nazwie firebase/crashlytics_events z etykietą errorType zdefiniowane w ten sposób:

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

  • Inne dane o nazwie firebase/session_events z etykietą eventType, zdefiniowane w ten sposób:

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

  Oto przykładowe zapytanie PromQL, które korzysta z tych wskaźników 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 na niestandardowe kanały powiadomień

Firebase oferuje domyślne Crashlytics alerty (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 publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack lub Jira.

Ten zaawansowany mechanizm alertów umożliwia też dostosowywanie informacji wysyłanych 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 specyficznych dla 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.

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