Personalizzazione degli avvisi di velocità

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 simili.

Cosa attiva un avviso?

Gli avvisi di velocità vengono attivati quando un problema nella tua app supera una soglia che definisci nella console Firebase.

Definisci la soglia per gli avvisi di velocità in termini di percentuale di sessioni utente interessate da un arresto anomalo. Puoi impostare un valore di soglia compreso tra lo 0,1% e l'1% delle sessioni. Per impostazione predefinita, la soglia di avviso di velocità è impostata sull'1% delle sessioni.

Nello specifico, viene attivato un avviso se, durante un periodo di un'ora, si verificano le seguenti condizioni:

  • Un problema in un'app supera la soglia definita per l'app.
  • L'app ha registrato 250 sessioni in quel periodo di tempo.
  • In precedenza non è stato generato alcun avviso per il problema nell'app.

Aggiorna la soglia di avviso

Per aggiornare gli avvisi di velocità, devi disporre dell'autorizzazione firebasecrashlytics.config.update. I seguenti ruoli includono questa autorizzazione obbligatoria per impostazione predefinita: Amministratore Firebase Crashlytics, Amministratore qualità Firebase, Amministratore Firebase o Proprietario o Editor del progetto.

Configura una soglia di avviso di velocità per ciascuna delle tue app registrate. Ogni app può avere una soglia di avviso diversa.

  1. Nella Firebase console, vai alla dashboard Crashlytics.
  2. Nella parte superiore della pagina, seleziona un'app dall'elenco a discesa.
  3. Nella barra superiore del riquadro Problemi, apri il menu extra (), quindi seleziona Impostazioni avviso velocità.
  4. Segui le istruzioni sullo schermo per configurare la soglia di avviso per l'app.

Ricevere avvisi

Ricevere avvisi predefiniti

Per impostazione predefinita, Firebase può inviare avvisi Crashlytics via 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/disattivare gli avvisi per il tuo account

Per il tuo account, puoi attivare/disattivare gli avvisi Crashlytics senza influire sugli altri membri del progetto. Tieni presente che devi comunque disporre delle autorizzazioni necessarie per ricevere gli avvisi.

Per attivare o disattivare gli avvisi Crashlytics, segui questi passaggi:

  1. Nella console Firebase, nell'angolo in alto a destra, vai a Avvisi Firebase.
  2. Poi, vai a Impostazioni e imposta la preferenza dell'account per gli avvisi 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.

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 gli avvisi avanzati per i 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:

  1. Configura Cloud Functions for Firebase, che include le seguenti attività:

    1. Configura un ambiente di sviluppo per Node.js o Python.
    2. Installa ed esegui l'accesso alla CLI Firebase.
    3. Inizializza Cloud Functions for Firebase utilizzando la CLI Firebase.

  2. 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.