Firebase può inviare una serie di avvisi Crashlytics predefiniti (consulta la pagina Panoramica degli avvisi). Firebase offre integrazioni di avvisi di base per inviare gli avvisi Crashlytics predefiniti 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 di avviso nella pagina
Impostazioni > Integrazioni della console Firebase.Seleziona la configurazione utilizzata per le singole app mobile e configura la destinazione degli altri avvisi nella scheda Crashlytics della pagina
Impostazioni > Avvisi della console Firebase.
Il resto di questa pagina descrive in dettaglio come configurare ogni integrazione di base per gli avvisi.
Slack: configura l'integrazione 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à in aumento.
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, consulta la documentazione di Slack sull'invio di 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:
Nella console Firebase, vai alla pagina
Impostazioni > Integrazioni.Nella scheda di integrazione di 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 il nome del canale. Puoi eseguire l'override di questa impostazione predefinita in un secondo momento per singola app o singolo 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 degli avvisi per Slack
Puoi configurare gli avvisi in base all'app mobile e al 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: attivato quando l'esperienza con l'app subisce un arresto anomalo o un ANR che Crashlytics non ha mai visto prima.
Nuovi problemi non irreversibili: attivato quando l'esperienza con l'app riscontra un problema non irreversibile che Crashlytics non ha mai rilevato prima.
Problemi con regressione: attivati quando l'esperienza con l'app subisce un arresto anomalo che avevi precedentemente contrassegnato come chiuso.
Problemi di tendenza: attivato quando un problema è emergente o di tendenza (non supportato per le app web).
Problemi con velocità in aumento: si attivano quando un singolo tipo di arresto anomalo o ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app (non supportato per le app web).
Configura le impostazioni per ogni app mobile
Ecco come configurare gli avvisi per ogni app mobile nel tuo progetto Firebase:
Nella console Firebase, vai alla pagina
Impostazioni > Avvisi.Vai alla scheda degli avvisi Crashlytics. Seleziona l'app mobile che vuoi configurare dal menu a discesa.
Seleziona il canale Slack in cui vuoi inviare gli avvisi per questa app.
Per ogni tipo di avviso, seleziona dal menu a discesa se vuoi inviare questo tipo di avviso a Slack.
Ripeti questi passaggi per ogni app mobile che vuoi configurare.
Ecco fatto. Firebase invierà avvisi ai canali Slack specificati se le tue app mobile presentano problemi nuovi, pregressi o con velocità in aumento.
Jira: configura l'integrazione con Jira
Dopo aver configurato l'integrazione di Firebase con Jira, il tuo progetto Firebase può pubblicare in un progetto Jira in risposta ai report Eventi segnalati da Crashlytics, come problemi nuovi, con regressione o con velocità in aumento. Puoi anche collegare singoli problemi di Crashlytics ai problemi di Jira.
Passaggio 1: prepara Jira per l'integrazione con Firebase
Crea 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, poiché ti servirà in un secondo momento.
Crea un tipo di problema "Bug"
L'integrazione di Firebase con Jira crea problemi con il tipo Bug. Devi creare questo tipo di problema nel tuo progetto Jira (se non esiste già).
Nella console Jira, vai a Project Settings (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 di Jira nella console Firebase
Configura l'integrazione Jira per Jira Cloud o per Jira Server.
Jira Cloud
Nella console Firebase, vai alla pagina
Impostazioni > Integrazioni.Nella scheda di integrazione di Jira, fai clic su Installa.
Fai clic su Configura l'integrazione di Jira.
Inserisci l'URL del progetto Jira nel seguente formato:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYInserisci l'indirizzo email di accesso a Jira e il token API.
Fai clic su Verifica e salva.
Jira Server
Nella console Firebase, vai alla pagina
Impostazioni > Integrazioni.Nella scheda di integrazione di Jira, fai clic su Installa.
Fai clic su Configura l'integrazione di Jira.
Inserisci l'URL del progetto Jira nel seguente formato:
https://SERVER_NAME.com/projects/PROJECT_KEYInserisci l'indirizzo email di accesso a Jira e il token API.
Fai clic su Verifica e salva.
Passaggio 3: configura le impostazioni degli avvisi per Jira
Puoi configurare gli avvisi in base all'app mobile e al tipo di evento. Ad esempio, puoi disattivare gli avvisi nell'app di test o indirizzare gli avvisi relativi a diverse app mobile a diversi progetti Jira.
Tipi di evento
L'integrazione di Firebase con Jira ti consente di inviare avvisi in risposta ai seguenti tipi di eventi:
Nuovi problemi irreversibili: attivato quando l'esperienza con l'app subisce un arresto anomalo o un ANR che Crashlytics non ha mai visto prima.
Nuovi problemi non irreversibili: attivato quando l'esperienza con l'app riscontra un problema non irreversibile che Crashlytics non ha mai rilevato prima.
Problemi con regressione: attivati quando l'esperienza con l'app subisce un arresto anomalo che avevi precedentemente contrassegnato come chiuso.
Problemi di tendenza: attivato quando un problema è emergente o di tendenza (non supportato per le app web).
Problemi con velocità in aumento: si attivano quando un singolo tipo di arresto anomalo o ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app (non supportato per le app web).
Configura le impostazioni per ogni app mobile
Ecco come configurare gli avvisi per ogni app mobile nel tuo progetto Firebase:
Nella console Firebase, vai alla pagina
Impostazioni > Avvisi.Vai alla scheda degli avvisi Crashlytics. Seleziona l'app mobile 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 quel tipo di avviso a Jira.
Ripeti questi passaggi per ogni app mobile che vuoi configurare.
Ecco fatto. Firebase invierà avvisi ai progetti Jira specificati se le tue app mobile presentano problemi nuovi, di regressione o di velocità crescente.
(Facoltativo) Collega i problemi di Crashlytics e i problemi di 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 di Crashlytics che vuoi collegare a un problema Jira.
Fai clic su Collega a Jira.
Fai clic su Crea problema nel progetto o incolla l'URL o la chiave del problema Jira nel campo fornito.
Scollega un problema di Crashlytics da un problema Jira
Vai al problema di Crashlytics che vuoi scollegare da Jira.
Fai clic su Problema collegato.
Fai clic su Altro e seleziona Scollega.
PagerDuty: configura l'integrazione con PagerDuty
Dopo aver configurato l'integrazione di Firebase con PagerDuty, il tuo progetto Firebase consente a PagerDuty di contattare i tuoi addetti alla risposta on-call in risposta ai report Eventi segnalati da Crashlytics, come problemi nuovi, pregressi o con velocità in aumento.
Passaggio 1: configura l'integrazione di PagerDuty nella console Firebase
Nella console Firebase, vai alla pagina
Impostazioni > Integrazioni.Nella scheda di integrazione di 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 in base all'app mobile e al tipo di evento. Ad esempio, puoi disattivare gli avvisi nell'app di test o indirizzare gli avvisi relativi a diverse app mobile a diversi progetti PagerDuty.
Tipi di evento
L'integrazione di Firebase con PagerDuty ti consente di inviare avvisi in risposta ai seguenti tipi di eventi:
Nuovi problemi irreversibili: attivato quando l'esperienza con l'app subisce un arresto anomalo o un ANR che Crashlytics non ha mai visto prima.
Nuovi problemi non irreversibili: attivato quando l'esperienza con l'app riscontra un problema non irreversibile che Crashlytics non ha mai rilevato prima.
Problemi con regressione: attivati quando l'esperienza con l'app subisce un arresto anomalo che avevi precedentemente contrassegnato come chiuso.
Problemi di tendenza: attivato quando un problema è emergente o di tendenza (non supportato per le app web).
Problemi con velocità in aumento: si attivano quando un singolo tipo di arresto anomalo o ANR interessa una percentuale di utenti in un periodo di 30 minuti per una determinata versione dell'app (non supportato per le app web).
Configura le impostazioni per ogni app mobile
Ecco come configurare gli avvisi per ogni app mobile nel tuo progetto Firebase:
Nella console Firebase, vai alla pagina
Impostazioni > Avvisi.Vai alla scheda degli avvisi Crashlytics. Seleziona l'app mobile 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 questo tipo di avviso a PagerDuty.
Ripeti questi passaggi per ogni app mobile che vuoi configurare.
Ecco fatto. Firebase pubblicherà i bug nel servizio PagerDuty specificato se le tue app mobile presentano problemi nuovi, di regressione o di velocità crescente.