Firebase offre integrazioni di avvisi di base per inviare avvisi Crashlytics a Slack, Jira e PagerDuty.
A livello generale, ecco come configurare queste integrazioni nella console Firebase:
Segui il flusso di lavoro guidato per ogni servizio nella scheda Integrazioni nelle
Impostazioni progetto .Seleziona la configurazione da utilizzare per le singole app e configura la destinazione degli altri avvisi nella scheda Crashlytics della scheda Avvisi nelle
Impostazioni progetto .
Il resto di questa pagina descrive in dettaglio come configurare ogni integrazione di avvisi di base.
Configura l'integrazione di base con Slack
Dopo aver configurato l'integrazione di Firebase con Slack, il tuo progetto può pubblicare nel tuo workspace Slack in risposta agli eventi segnalati da Crashlytics, come problemi nuovi, pregressi o con velocità crescente.
Passaggio 1: configura un webhook Slack
Prima di configurare l'integrazione in Firebase, devi aggiungere un webhook in entrata in Slack per gestire le comunicazioni da Firebase.
Per scoprire come fare, leggi la documentazione di Slack su come inviare messaggi utilizzando i webhook in entrata.
Passaggio 2: configura l'integrazione di Slack nella console Firebase
Dopo aver configurato il webhook appropriato, puoi configurare l'integrazione per Crashlytics:
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Integrazioni.
Nella scheda di integrazione Slack, fai clic su Installa.
Configura l'integrazione impostando i valori nei seguenti campi:
URL webhook: incolla l'URL webhook dalla pagina delle impostazioni di Slack.
Canale predefinito: inserisci un nome del canale. Puoi eseguire l'override di questa impostazione predefinita in un secondo momento per ogni app o avviso.
Nome dell'utente che pubblica: inserisci un nome con cui inviare i messaggi.
Fai clic su Verifica e salva.
Dopo aver verificato e salvato l'integrazione di Slack, dovresti visualizzare un messaggio di conferma nel canale predefinito che hai selezionato.
Passaggio 3: configura le impostazioni di avviso per Slack
Puoi configurare gli avvisi per app e tipo di evento. Ad esempio, puoi disattivare
gli avvisi nell'app di test o indirizzare gli avvisi ad alta priorità nell'app di produzione
a un canale #urgent.
Tipi di evento
L'integrazione di Firebase con Slack ti consente di inviare avvisi in risposta ai seguenti tipi di eventi:
Nuovi problemi irreversibili: attivati quando si verifica un arresto anomalo o un errore ANR che Crashlytics non ha mai registrato.
Nuovi problemi non irreversibili: attivati quando si verifica un problema non irreversibile nella tua app Crashlytics mai registrato.
Problemi di regressione: attivati quando si verifica un arresto anomalo dell'app che avevi precedentemente contrassegnato come chiuso.
Problemi più frequenti: attivati quando un problema è emergente o frequente.
Problemi con velocità crescente: si attivano quando un singolo tipo di arresto anomalo o errore ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app.
Configurare le impostazioni per ogni app
Ecco come configurare gli avvisi per ogni app nel tuo progetto Firebase:
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Avvisi.
Vai alla scheda degli avvisi Crashlytics. Seleziona l'app che vuoi configurare dal menu a discesa.
Seleziona il canale Slack in cui vuoi inviare avvisi per questa app.
Per ogni tipo di avviso, seleziona dal menu a discesa se vuoi inviare quel tipo di avviso a Slack.
Ripeti questi passaggi per ogni app che vuoi configurare.
Ecco fatto. Firebase invierà avvisi ai canali Slack specificati se le tue app presentano problemi nuovi, di regressione o di velocità crescente.
Configura l'integrazione di base con Jira
Dopo aver configurato l'integrazione di Firebase con Jira, il tuo progetto Firebase può pubblicare in un progetto Jira in risposta agli eventi segnalati da Crashlytics, ad esempio problemi nuovi, regrediti o con velocità crescente. Puoi anche collegare singoli problemi di Crashlytics ai problemi di Jira.
Passaggio 1: prepara Jira per l'integrazione con Firebase
Creare un token API (solo Jira Cloud)
Prima di configurare l'integrazione in Firebase, devi generare un token API in Jira Cloud.
Nella console Jira, apri le impostazioni dei token API.
Fai clic su Genera token API.
Salva questo token API in un luogo sicuro, in quanto ti servirà in un secondo momento.
Crea un tipo di problema "Bug"
L'integrazione di Firebase con Jira crea problemi di tipo Bug. Devi
creare questo tipo di problema nel tuo progetto Jira (se non esiste
già).
Nella console Jira, vai a Impostazioni progetto.
Fai clic su Tipi di problemi.
Fai clic su Aggiungi tipo di problema.
Seleziona "Bug" o inseriscilo manualmente.
Passaggio 2: configura l'integrazione Jira nella console Firebase
Configura l'integrazione Jira per Jira Cloud o per Jira Server.
Jira Cloud
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Integrazioni.
Nella scheda di integrazione Jira, fai clic su Installa.
Fai clic su Configura l'integrazione Jira.
Inserisci l'URL del progetto Jira nel seguente formato:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYInserisci l'email di accesso a Jira e il token API.
Fai clic su Verifica e salva.
Jira Server
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Integrazioni.
Nella scheda di integrazione Jira, fai clic su Installa.
Fai clic su Configura l'integrazione Jira.
Inserisci l'URL del progetto Jira nel seguente formato:
https://SERVER_NAME.com/projects/PROJECT_KEYInserisci l'email di accesso a Jira e il token API.
Fai clic su Verifica e salva.
Passaggio 3: configura le impostazioni di avviso per Jira
Puoi configurare gli avvisi per app e tipo di evento. Ad esempio, puoi disattivare gli avvisi nell'app di test o indirizzare gli avvisi relativi a diverse app a progetti Jira diversi.
Tipi di evento
L'integrazione di Firebase con Jira consente di inviare avvisi in risposta ai seguenti tipi di eventi:
Nuovi problemi irreversibili: attivati quando si verifica un arresto anomalo o un errore ANR che Crashlytics non ha mai registrato.
Nuovi problemi non irreversibili: attivati quando si verifica un problema non irreversibile nella tua app Crashlytics mai registrato.
Problemi di regressione: attivati quando si verifica un arresto anomalo dell'app che avevi precedentemente contrassegnato come chiuso.
Problemi più frequenti: attivati quando un problema è emergente o frequente.
Problemi con velocità crescente: si attivano quando un singolo tipo di arresto anomalo o errore ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app.
Configurare le impostazioni per ogni app
Ecco come configurare gli avvisi per ogni app nel tuo progetto Firebase:
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Avvisi.
Vai alla scheda degli avvisi Crashlytics. Seleziona l'app che vuoi configurare dal menu a discesa.
Seleziona il progetto Jira in cui vuoi inviare avvisi per questa app.
Per ogni tipo di avviso, seleziona dal menu a discesa se vuoi inviare questo tipo di avviso a Jira.
Ripeti questi passaggi per ogni app che vuoi configurare.
Ecco fatto. Firebase invierà avvisi ai progetti Jira specificati se le tue app presentano problemi nuovi, regressi o con velocità crescente.
(Facoltativo) Collega i problemi Crashlytics e i problemi Jira
Oltre ai problemi Jira creati automaticamente da Firebase, è possibile collegare i problemi Crashlytics ai problemi Jira esistenti. Puoi anche creare un nuovo problema Jira dalla console Firebase. Prima di utilizzare questa funzionalità, devi attivare l'integrazione di Jira.
Vai al problema Crashlytics che vuoi collegare a un problema Jira.
Fai clic su Collega a Jira.
Fai clic su Crea problema nel progetto oppure incolla l'URL o la chiave del problema Jira nel campo fornito.
Scollega un problema Crashlytics da un problema Jira
Vai al problema Crashlytics che vuoi scollegare da Jira.
Fai clic su Problema collegato.
Fai clic su Altro e seleziona Scollega.
Configura l'integrazione di base con PagerDuty
Dopo aver configurato l'integrazione di Firebase con PagerDuty, il tuo progetto Firebase consente a PagerDuty di inviare una notifica ai tuoi responsabili di turno in risposta agli eventi segnalati da Crashlytics, come problemi nuovi, regressi o con velocità crescente.
Passaggio 1: configura l'integrazione PagerDuty nella console Firebase
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Integrazioni.
Nella scheda di integrazione PagerDuty, fai clic su Installa.
Segui le istruzioni sullo schermo per configurare l'integrazione.
Fai clic su Verifica e salva.
Passaggio 2: configura le impostazioni degli avvisi per PagerDuty
Puoi configurare gli avvisi per app e tipo di evento. Ad esempio, puoi disattivare gli avvisi nell'app di test o indirizzare gli avvisi relativi a diverse app a progetti PagerDuty diversi.
Tipi di evento
L'integrazione di Firebase con PagerDuty consente di inviare avvisi in risposta ai seguenti tipi di eventi:
Nuovi problemi irreversibili: attivati quando si verifica un arresto anomalo o un errore ANR che Crashlytics non ha mai registrato.
Nuovi problemi non irreversibili: attivati quando si verifica un problema non irreversibile nella tua app Crashlytics mai registrato.
Problemi di regressione: attivati quando si verifica un arresto anomalo dell'app che avevi precedentemente contrassegnato come chiuso.
Problemi più frequenti: attivati quando un problema è emergente o frequente.
Problemi con velocità crescente: si attivano quando un singolo tipo di arresto anomalo o errore ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app.
Configurare le impostazioni per ogni app
Ecco come configurare gli avvisi per ogni app nel tuo progetto Firebase:
Accedi alla console Firebase, quindi seleziona il tuo progetto.
Fai clic su e seleziona Impostazioni progetto.
Seleziona la scheda Avvisi.
Vai alla scheda degli avvisi Crashlytics. Seleziona l'app che vuoi configurare dal menu a discesa.
Seleziona il servizio PagerDuty a cui vuoi inviare avvisi per questa app.
Per ogni tipo di avviso, seleziona dal menu a discesa se vuoi inviare quel tipo di avviso a PagerDuty.
Ripeti questi passaggi per ogni app che vuoi configurare.
Ecco fatto. Firebase pubblicherà i bug nel servizio PagerDuty specificato se le tue app presentano problemi nuovi, pregressi o con velocità crescente.