Utilizza gli avvisi di velocità per notificare al tuo team quando un singolo problema sta causando un problema urgente nella tua app. Per Crashlytics, un problema è un raggruppamento di arresti anomali o eventi di mancata risposta dell'applicazione (ANR) simili.
Cosa attiva un avviso?
Gli avvisi di velocità vengono attivati quando un problema nella tua app supera determinate soglie che configuri nella console Firebase.
Definisci la soglia per gli avvisi di velocità in termini di percentuale di utenti e numero minimo di utenti interessati dall'arresto anomalo o dall'errore ANR. Puoi impostare il valore della soglia percentuale tra lo 0% e il 100% delle sessioni. La soglia minima di utenti può essere impostata su qualsiasi numero maggiore o uguale a 10. Per impostazione predefinita, la soglia di avviso di velocità è impostata all'1% delle sessioni e a 25 utenti.
Nello specifico, viene attivato un avviso se, durante un periodo di 30 minuti, tutte le seguenti condizioni sono vere:
- Un problema in un'app supera la soglia percentuale definita e il numero minimo di utenti impostato per l'app.
- L'app ha almeno 10 utenti in quel periodo di tempo.
- In precedenza non è stato generato alcun avviso per il problema nell'app in quella versione.
Configurare le soglie degli avvisi di velocità
Per configurare le soglie degli avvisi di velocità, devi disporre dell'autorizzazione
firebasecrashlytics.config.update. I seguenti ruoli includono
questa autorizzazione richiesta per impostazione predefinita:
Firebase Crashlytics Admin,
Firebase Quality Admin,
Firebase Admin o
Proprietario o Editor del progetto.
Configura le soglie di avviso di velocità per ciascuna delle tue app registrate. Ogni app può avere una soglia di avviso diversa.
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 e seleziona la scheda Avvisi di velocità.
Configura le soglie degli avvisi per l'app.
Ricevere avvisi
Ricevere avvisi predefiniti
Per impostazione predefinita, Firebase può inviare avvisi Crashlytics tramite email. Per gli avvisi e le regressioni di velocità, Firebase può mostrare questi avvisi anche nella console Firebase.
Per ricevere avvisi Crashlytics utilizzando questo meccanismo predefinito, devi disporre dell'autorizzazione firebase.projects.update. I seguenti ruoli includono questa
autorizzazione obbligatoria per impostazione predefinita:
Amministratore Firebase o
Proprietario o Editor del progetto.
Per impostazione predefinita, ogni membro del progetto (che dispone delle autorizzazioni necessarie per ricevere avvisi) riceverà un'email quando viene attivato un avviso da Crashlytics.
Attivare o disattivare gli avvisi per il tuo account
Per il tuo account, puoi attivare o disattivare gli avvisi Crashlytics senza influire sugli altri membri del progetto. Tieni presente che devi comunque disporre delle autorizzazioni necessarie per ricevere gli avvisi.
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 e seleziona la scheda Avvisi di velocità.
Imposta la preferenza dell'account per gli avvisi di Crashlytics.
Configurare gli avvisi di base per i servizi di terze parti
Per gli avvisi Crashlytics, Firebase offre un meccanismo per inviare avvisi ai seguenti servizi di terze parti: Slack, Jira o PagerDuty.
Configura queste opzioni di avviso di base utilizzando i flussi di lavoro guidati nella scheda Integrazioni nelle
impostazioni del progetto .Seleziona la configurazione da utilizzare per le singole app e configura la destinazione degli altri avvisi nella scheda Crashlytics Avvisi nelle
impostazioni del progetto .
Tieni presente che se vuoi un maggiore controllo e personalizzazione per l'invio di avvisi a qualsiasi servizio di terze parti (non limitato solo a Slack, Jira o PagerDuty), consulta la sezione Configurare avvisi avanzati per servizi di terze parti che descrive le opzioni di avviso avanzate.
Configurare avvisi avanzati per servizi di terze parti
Puoi inviare avvisi Crashlytics al canale di notifica preferito del tuo team utilizzando Cloud Functions for Firebase. Ad esempio, puoi scrivere una funzione che acquisisce un evento di avviso per gli avvisi di velocità e pubblica le informazioni sull'avviso su un servizio di terze parti, come Discord, Slack o Jira. Con questo meccanismo di avviso avanzato, puoi personalizzare completamente le informazioni inviate al servizio di terze parti; ad esempio, puoi includere deep link utili nella console Firebase o aggiungere informazioni per la risoluzione dei problemi specifiche dell'azienda.
Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase:
Configura Cloud Functions for Firebase, che include le seguenti attività:
- Configura un ambiente di sviluppo per Node.js o Python.
- Installa ed esegui l'accesso alla CLI Firebase.
- Inizializza Cloud Functions for Firebase utilizzando la CLI Firebase.
Scrivi ed esegui il deployment di una funzione che acquisisce un evento di avviso da Crashlytics e gestisce il payload dell'evento (ad esempio, pubblica le informazioni sull'avviso in un messaggio su Discord).
Per scoprire tutti gli eventi di avviso Crashlytics che puoi acquisire, consulta la documentazione di riferimento per gli avvisi Crashlytics.