Firebase może wysyłać różne domyślne Crashlytics alerty (więcej informacji znajdziesz na stronie Przegląd alertów). Firebase oferuje podstawowe integracje alertów, które umożliwiają wysyłanie domyślnych Crashlytics alertów do Slacka, Jiry i PagerDuty.
Oto ogólny opis, jak skonfigurować te integracje w Firebase konsoli:
Postępuj zgodnie z instrukcjami w przypadku każdej usługi alertów na
stronie ustawień > Integracje konsoli.FirebaseWybierz konfigurację, która ma być używana w przypadku poszczególnych aplikacji, i skonfiguruj miejsce docelowe innych alertów na karcie Crashlytics na
stronie ustawień Ustawienia > Alerty w konsoli Firebase.
W dalszej części tej strony znajdziesz szczegółowe informacje o tym, jak skonfigurować każdą podstawową integrację alertów.
Slack: konfigurowanie integracji ze Slackiem
Po skonfigurowaniu integracji Firebase ze Slackiem Twój projekt może publikować posty w Twojej przestrzeni roboczej Slacka w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.
Krok 1. Skonfiguruj webhooka Slacka
Zanim skonfigurujesz integrację w Firebase, musisz dodać przychodzącego webhooka w Slacku, aby obsługiwać komunikację z Firebase.
Aby dowiedzieć się, jak to zrobić, przeczytaj dokumentację Slacka na temat wysyłania wiadomości za pomocą przychodzących webhooków.
Krok 2. Skonfiguruj integrację ze Slackiem w konsoli Firebase
Po skonfigurowaniu odpowiedniego webhooka możesz skonfigurować integrację z Crashlytics:
W konsoli Firebase otwórz stronę
Ustawienia > Integracje.Na karcie integracji Slack kliknij Zainstaluj.
Skonfiguruj integrację, ustawiając wartości w tych polach:
Webhook URL (Adres URL webhooka): wklej adres URL webhooka ze strony ustawień Slacka.
Default channel (Kanał domyślny): wpisz nazwę kanału. Możesz później zastąpić tę wartość domyślną w przypadku poszczególnych aplikacji lub alertów.
Name of posting user (Nazwa użytkownika publikującego): wpisz nazwę, pod którą mają być wysyłane wiadomości.
Kliknij Potwierdź i zapisz.
Po potwierdzeniu i zapisaniu integracji ze Slackiem w wybranym kanale domyślnym powinna się pojawić wiadomość z potwierdzeniem.
Krok 3. Skonfiguruj ustawienia alertów dla Slacka
Alerty możesz skonfigurować według aplikacji i typu zdarzenia. Możesz na przykład wyłączyć alerty w aplikacji testowej lub kierować alerty o wysokim priorytecie w aplikacji produkcyjnej do kanału #urgent.
Typy zdarzeń
Integracja Firebase ze Slackiem umożliwia wysyłanie alertów w odpowiedzi na te typy zdarzeń:
New fatal issues (Nowe poważne problemy): aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR który Crashlytics nie został wcześniej wykryty.
New non-fatal issues (Nowe problemy niekrytyczne): aktywowane, gdy w aplikacji wystąpi problem niekrytyczny, którego Crashlytics nie wykrył wcześniej.
Regressed issues (Problemy pojawiające się ponownie): aktywowane, gdy w aplikacji wystąpi awaria, którą wcześniej oznaczono jako zamkniętą.
Trending issues (Problemy zyskujące popularność): aktywowane, gdy problem zaczyna się pojawiać lub zyskuje popularność.
Increasing-velocity issues (Problemy o rosnącej liczbie wystąpień): aktywowane, gdy pojedynczy typ awarii lub błędu ANR wpływa na określony odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.
Konfigurowanie ustawień poszczególnych aplikacji
Oto jak skonfigurować alerty dla każdej aplikacji w projekcie w Firebase:
W konsoli Firebase otwórz stronę
Ustawienia > Alerty page.Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.
Wybierz kanał Slacka, na który chcesz wysyłać alerty dotyczące tej aplikacji.
W przypadku każdego typu alertu wybierz w menu, czy chcesz wysyłać ten typ alertu do Slacka.
Powtórz te czynności w przypadku każdej aplikacji, którą chcesz skonfigurować.
To wszystko. Firebase będzie wysyłać alerty do określonych kanałów Slacka, jeśli w Twoich aplikacjach wystąpią nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.
Jira: konfigurowanie integracji z Jirą
Po skonfigurowaniu integracji Firebase z Jirą Twój projekt w Firebase może publikować posty w projekcie Jira w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień. Możesz też łączyć poszczególne Crashlytics problemy z problemami Jira.
Krok 1. Przygotuj Jirę do integracji z Firebase
Utwórz token API (tylko Jira Cloud)
Zanim skonfigurujesz integrację w Firebase, musisz wygenerować token API w Jira Cloud.
W konsoli Jira otwórz ustawienia tokenów API.
Kliknij Utwórz token API.
Zapisz ten token API w bezpiecznym miejscu, ponieważ będzie potrzebny później.
Utwórz typ problemu „Błąd”
Integracja Firebase z Jirą tworzy problemy typu Bug (Błąd). Musisz utworzyć ten typ problemu w projekcie Jira (jeśli jeszcze nie istnieje).
W konsoli Jira otwórz Ustawienia projektu.
Kliknij Typy problemów.
Kliknij Dodaj typ problemu.
Wybierz „Błąd” lub wpisz go ręcznie.
Krok 2. Skonfiguruj integrację z Jirą w konsoli Firebase
Skonfiguruj integrację z Jirą w przypadku Jira Cloud lub Jira Server.
Jira Cloud
W konsoli Firebase otwórz stronę
Ustawienia > Integracje.Na karcie integracji Jira kliknij Zainstaluj.
Kliknij Skonfiguruj integrację z Jirą.
Wpisz adres URL projektu Jira w tym formacie:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYWpisz adres e-mail używany do logowania się w Jirze i token API.
Kliknij Potwierdź i zapisz.
Jira Server
W konsoli Firebase otwórz stronę
Ustawienia > Integracje.Na karcie integracji Jira kliknij Zainstaluj.
Kliknij Skonfiguruj integrację z Jirą.
Wpisz adres URL projektu Jira w tym formacie:
https://SERVER_NAME.com/projects/PROJECT_KEYWpisz adres e-mail używany do logowania się w Jirze i token API.
Kliknij Potwierdź i zapisz.
Krok 3. Skonfiguruj ustawienia alertów dla Jiry
Alerty możesz skonfigurować według aplikacji i typu zdarzenia. Możesz na przykład wyłączyć alerty w aplikacji testowej lub kierować alerty dotyczące różnych aplikacji do różnych projektów Jira.
Typy zdarzeń
Integracja Firebase z Jirą umożliwia wysyłanie alertów w odpowiedzi na te typy zdarzeń:
New fatal issues (Nowe poważne problemy): aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR który Crashlytics nie został wcześniej wykryty.
New non-fatal issues (Nowe problemy niekrytyczne): aktywowane, gdy w aplikacji wystąpi problem niekrytyczny, którego Crashlytics nie wykrył wcześniej.
Regressed issues (Problemy pojawiające się ponownie): aktywowane, gdy w aplikacji wystąpi awaria, którą wcześniej oznaczono jako zamkniętą.
Trending issues (Problemy zyskujące popularność): aktywowane, gdy problem zaczyna się pojawiać lub zyskuje popularność.
Increasing-velocity issues (Problemy o rosnącej liczbie wystąpień): aktywowane, gdy pojedynczy typ awarii lub błędu ANR wpływa na określony odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.
Konfigurowanie ustawień poszczególnych aplikacji
Oto jak skonfigurować alerty dla każdej aplikacji w projekcie w Firebase:
W konsoli Firebase otwórz stronę
Ustawienia > Alerty page.Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.
Wybierz projekt Jira, na który chcesz wysyłać alerty dotyczące tej aplikacji.
W przypadku każdego typu alertu wybierz w menu, czy chcesz wysyłać ten typ alertu do Jiry.
Powtórz te czynności w przypadku każdej aplikacji, którą chcesz skonfigurować.
To wszystko. Firebase będzie wysyłać alerty do określonych projektów Jira, jeśli w Twoich aplikacjach wystąpią nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.
(Opcjonalnie) Łączenie problemów Crashlytics z problemami Jira
Oprócz automatycznie tworzonych problemów Jira, które tworzy Firebase, możesz łączyć problemy Crashlytics z istniejącymi problemami Jira. Możesz też utworzyć nowy problem Jira w konsoli Firebase. Zanim zaczniesz korzystać z tej funkcji, musisz włączyć integrację z Jirą.
Otwórz problem Crashlytics, który chcesz połączyć z problemem Jira.
Kliknij Połącz z Jirą.
Kliknij Utwórz problem w projekcie lub wklej adres URL problemu Jira albo klucz problemu w odpowiednim polu.
Rozłączanie problemu Crashlytics z problemem Jira
Otwórz problem Crashlytics, który chcesz rozłączyć z Jirą.
Kliknij Połączony problem.
Kliknij Więcej i wybierz Rozłącz.
PagerDuty: konfigurowanie integracji z PagerDuty
Po skonfigurowaniu integracji Firebase z PagerDuty Twój projekt w Firebase umożliwia PagerDuty powiadamianie osób dyżurujących w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.
Krok 1. Skonfiguruj integrację z PagerDuty w konsoli Firebase
W konsoli Firebase otwórz stronę
Ustawienia > Integracje.Na karcie integracji PagerDuty kliknij Zainstaluj.
Aby skonfigurować integrację, postępuj zgodnie z instrukcjami na ekranie.
Kliknij Potwierdź i zapisz.
Krok 2. Skonfiguruj ustawienia alertów dla PagerDuty
Alerty możesz skonfigurować według aplikacji i typu zdarzenia. Możesz na przykład wyłączyć alerty w aplikacji testowej lub kierować alerty dotyczące różnych aplikacji do różnych projektów PagerDuty.
Typy zdarzeń
Integracja Firebase z PagerDuty umożliwia wysyłanie alertów w odpowiedzi na te typy zdarzeń:
New fatal issues (Nowe poważne problemy): aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR który Crashlytics nie został wcześniej wykryty.
New non-fatal issues (Nowe problemy niekrytyczne): aktywowane, gdy w aplikacji wystąpi problem niekrytyczny, którego Crashlytics nie wykrył wcześniej.
Regressed issues (Problemy pojawiające się ponownie): aktywowane, gdy w aplikacji wystąpi awaria, którą wcześniej oznaczono jako zamkniętą.
Trending issues (Problemy zyskujące popularność): aktywowane, gdy problem zaczyna się pojawiać lub zyskuje popularność.
Increasing-velocity issues (Problemy o rosnącej liczbie wystąpień): aktywowane, gdy pojedynczy typ awarii lub błędu ANR wpływa na określony odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.
Konfigurowanie ustawień poszczególnych aplikacji
Oto jak skonfigurować alerty dla każdej aplikacji w projekcie w Firebase:
W konsoli Firebase otwórz stronę
Ustawienia > Alerty page.Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.
Wybierz usługę PagerDuty, na którą chcesz wysyłać alerty dotyczące tej aplikacji.
W przypadku każdego typu alertu wybierz w menu, czy chcesz wysyłać ten typ alertu do PagerDuty.
Powtórz te czynności w przypadku każdej aplikacji, którą chcesz skonfigurować.
To wszystko. Firebase będzie publikować błędy w określonej usłudze PagerDuty, jeśli w Twoich aplikacjach wystąpią nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.