Konfigurowanie podstawowych integracji alertów z usługami Slack, Jira i PagerDuty

Firebase oferuje podstawowe integracje alertów, które umożliwiają wysyłanie Crashlytics alertów do Slacka, Jiry i PagerDuty.

Ogólnie rzecz biorąc, integracje te możesz skonfigurować w konsoliFirebase w ten sposób:

  1. Postępuj zgodnie z instrukcjami dla każdej usługi na karcie Integracje ustawieniach projektu.

  2. Wybierz konfigurację, która będzie używana w przypadku poszczególnych aplikacji, i skonfiguruj miejsce docelowe innych alertów na karcie Crashlytics na karcie Alerty ustawieniach projektu.


W dalszej części tej strony znajdziesz szczegółowe informacje o konfigurowaniu każdej podstawowej integracji alertów.

Slack Jira PagerDuty



Konfigurowanie podstawowej integracji z usługą Slack

Przykład alertu Crashlytics wysłanego na kanał Slacka

Po skonfigurowaniu integracji Firebase ze Slackiem Twój projekt może publikować informacje w przestrzeni roboczej Slacka w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe, pogorszone lub coraz częstsze problemy.

Krok 1. Skonfiguruj webhooka Slacka

Zanim skonfigurujesz integrację w Firebase, musisz dodać w Slacku przychodzący webhook, który będzie obsługiwać komunikację z Firebase.

Aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Slacka na temat wysyłania wiadomości za pomocą przychodzących webhooków.

Krok 2. Skonfiguruj integrację Slacka w konsoli Firebase.

Po skonfigurowaniu odpowiedniego webhooka możesz skonfigurować integrację z Crashlytics:

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Kliknij kartę Integracje.

  4. Na karcie integracji Slack kliknij Zainstaluj.

  5. Skonfiguruj integrację, ustawiając wartości w tych polach:

    • Adres URL webhooka: wklej adres URL webhooka ze strony ustawień Slacka.

    • Kanał domyślny: wpisz nazwę kanału. Możesz później zastąpić to ustawienie domyślne w przypadku poszczególnych aplikacji lub alertów.

    • Nazwa użytkownika publikującego: wpisz nazwę, pod którą będą wysyłane wiadomości.

  6. Kliknij Potwierdź i zapisz.

Po zweryfikowaniu i zapisaniu integracji ze Slackiem w wybranym kanale domyślnym powinien pojawić się komunikat z potwierdzeniem.

Krok 3. Skonfiguruj ustawienia alertów w Slacku

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 na kanał #urgent.

Typy zdarzeń

Integracja Firebase ze Slackiem umożliwia wysyłanie alertów w odpowiedzi na te typy zdarzeń:

  • Nowe poważne problemy: aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR, który nie został wcześniej wykryty przez Crashlytics.

  • Nowe problemy niekrytyczne: aktywowane, gdy w aplikacji wystąpi problem niekrytyczny Crashlytics, który nie został wcześniej wykryty.

  • Problemy, które powróciły: aktywowane, gdy w aplikacji wystąpi awaria, która została wcześniej oznaczona jako rozwiązana.

  • Częste problemy: wywoływane, gdy pojawia się nowy problem lub gdy problem staje się popularny.

  • Problemy o rosnącej częstotliwości: wywoływane, gdy jeden typ awarii lub błędu ANR wpływa na odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.

Konfigurowanie ustawień poszczególnych aplikacji

Aby skonfigurować alerty dla każdej aplikacji w projekcie Firebase:

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Wybierz kartę Alerty.

  4. Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.

  5. Wybierz kanał Slacka, na który chcesz wysyłać alerty dotyczące tej aplikacji.

  6. W przypadku każdego typu alertu wybierz z menu, czy chcesz wysyłać ten typ alertu do Slacka.

  7. 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 pojawią się nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.



Konfigurowanie podstawowej integracji z Jira

Po skonfigurowaniu integracji Firebase z Jira projekt Firebase może wysyłać posty do projektu Jira w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe, powracające lub coraz częstsze problemy. Możesz też połączyć poszczególne problemy z problemami w Jira.Crashlytics

Krok 1. Przygotuj Jira do integracji z Firebase

Tworzenie tokena API (tylko Jira Cloud)

Zanim skonfigurujesz integrację w Firebase, musisz wygenerować token interfejsu API w Jira Cloud.

  1. W konsoli Jira otwórz ustawienia tokenów API.

  2. Kliknij Create API token (Utwórz token API).

  3. Zapisz ten token interfejsu API w bezpiecznym miejscu, ponieważ będzie potrzebny później.

Tworzenie typu zgłoszenia „Błąd”

Integracja Firebase z Jira tworzy problemy typu Bug. Musisz utworzyć ten typ zgłoszenia w projekcie Jira (jeśli jeszcze nie istnieje).

  1. W konsoli Jira otwórz Ustawienia projektu.

  2. Kliknij Typy problemów.

  3. Kliknij Dodaj typ problemu.

  4. Wybierz „Błąd” lub wpisz go ręcznie.

Krok 2. Skonfiguruj integrację z Jirą w konsoli Firebase

Skonfiguruj integrację z Jira w przypadku Jira Cloud lub Jira Server.

Jira Cloud

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Kliknij kartę Integracje.

  4. Na karcie integracji Jira kliknij Zainstaluj.

  5. Kliknij Skonfiguruj integrację z Jirą.

  6. Wpisz adres URL projektu Jira w tym formacie:https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEY

  7. Wpisz adres e-mail logowania do Jiry i token API.

  8. Kliknij Potwierdź i zapisz.

Jira Server

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Kliknij kartę Integracje.

  4. Na karcie integracji Jira kliknij Zainstaluj.

  5. Kliknij Skonfiguruj integrację z Jirą.

  6. Wpisz adres URL projektu Jira w tym formacie:https://SERVER_NAME.com/projects/PROJECT_KEY

  7. Wpisz adres e-mail logowania do Jiry i token API.

  8. Kliknij Potwierdź i zapisz.

Krok 3. Skonfiguruj ustawienia alertów w Jira

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 Jira umożliwia wysyłanie alertów w odpowiedzi na te typy zdarzeń:

  • Nowe poważne problemy: aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR, który nie został wcześniej wykryty przez Crashlytics.

  • Nowe problemy niekrytyczne: aktywowane, gdy w aplikacji wystąpi problem niekrytyczny Crashlytics, który nie został wcześniej wykryty.

  • Problemy, które powróciły: aktywowane, gdy w aplikacji wystąpi awaria, która została wcześniej oznaczona jako rozwiązana.

  • Częste problemy: wywoływane, gdy pojawia się nowy problem lub gdy problem staje się popularny.

  • Problemy o rosnącej częstotliwości: wywoływane, gdy jeden typ awarii lub błędu ANR wpływa na odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.

Konfigurowanie ustawień poszczególnych aplikacji

Aby skonfigurować alerty dla każdej aplikacji w projekcie Firebase:

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Wybierz kartę Alerty.

  4. Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.

  5. Wybierz projekt Jira, do którego chcesz wysyłać alerty dotyczące tej aplikacji.

  6. W przypadku każdego typu alertu wybierz z menu, czy chcesz wysyłać ten typ alertu do Jiry.

  7. 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 pojawią się nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.

Oprócz automatycznie tworzonych przez Firebase zgłoszeń problemów w Jira możesz połączyć problemy Crashlytics z istniejącymi zgłoszeniami problemów w Jira. Nowy problem w Jira możesz też utworzyć w Firebase konsoli. Zanim skorzystasz z tej funkcji, musisz włączyć integrację z Jira.

  1. Przejdź do problemu Crashlytics, który chcesz połączyć z problemem w Jira.

  2. Kliknij Połącz z Jirą.

  3. Kliknij Utwórz zgłoszenie w projekcie lub wklej adres URL zgłoszenia w Jira albo klucz zgłoszenia w odpowiednim polu.

  1. Przejdź do Crashlytics, które chcesz odłączyć od Jiry.

  2. Kliknij Powiązany problem.

  3. Kliknij Więcej i wybierz Odłącz.



Konfigurowanie podstawowej integracji z PagerDuty

Po skonfigurowaniu integracji Firebase z PagerDuty projekt Firebase umożliwia PagerDuty powiadamianie osób dyżurujących w odpowiedzi na zdarzenia zgłaszane przez Crashlytics, takie jak nowe, powracające lub coraz częstsze problemy.

Krok 1. Skonfiguruj integrację z PagerDuty w konsoli Firebase.

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Kliknij kartę Integracje.

  4. Na karcie integracji PagerDuty kliknij Zainstaluj.

  5. Aby skonfigurować integrację, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

  6. Kliknij Potwierdź i zapisz.

Krok 2. Skonfiguruj ustawienia alertów w 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ń:

  • Nowe poważne problemy: aktywowane, gdy w aplikacji wystąpi awaria lub błąd ANR, który nie został wcześniej wykryty przez Crashlytics.

  • Nowe problemy niekrytyczne: aktywowane, gdy w aplikacji wystąpi problem niekrytyczny Crashlytics, który nie został wcześniej wykryty.

  • Problemy, które powróciły: aktywowane, gdy w aplikacji wystąpi awaria, która została wcześniej oznaczona jako rozwiązana.

  • Częste problemy: wywoływane, gdy pojawia się nowy problem lub gdy problem staje się popularny.

  • Problemy o rosnącej częstotliwości: wywoływane, gdy jeden typ awarii lub błędu ANR wpływa na odsetek użytkowników w 30-minutowym okresie w przypadku danej wersji aplikacji.

Konfigurowanie ustawień poszczególnych aplikacji

Aby skonfigurować alerty dla każdej aplikacji w projekcie Firebase:

  1. Zaloguj się w Firebase konsoli i wybierz swój projekt.

  2. Kliknij , a następnie wybierz Ustawienia projektu.

  3. Wybierz kartę Alerty.

  4. Otwórz kartę alertów Crashlytics. W menu wybierz aplikację, którą chcesz skonfigurować.

  5. Wybierz usługę PagerDuty, do której chcesz wysyłać alerty dotyczące tej aplikacji.

  6. W przypadku każdego typu alertu wybierz z menu, czy chcesz wysyłać ten typ alertu do PagerDuty.

  7. 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 pojawią się nowe problemy, problemy pojawiające się ponownie lub problemy o rosnącej liczbie wystąpień.