Personalizzazione degli avvisi di velocità

Utilizza gli avvisi di velocità per notificare al tuo team quando un singolo problema causa un problema urgente nella tua app. Per Crashlytics, un problema è un raggruppamento di arresti anomali simili.

Che cosa attiva un avviso?

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

La soglia per gli avvisi sulla velocità viene definita in termini di percentuale di sessioni dell'utente interessate da un arresto anomalo. Puoi impostare un valore della soglia compreso tra il 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 tempo di un'ora, si verificano le seguenti condizioni:

  • Un problema in un'app supera la soglia definita per quell'app.
  • L'app ha registrato 250 sessioni in questo periodo di tempo.
  • Non è stato generato alcun avviso per il problema nell'app.

Aggiornare la soglia di avviso

Per aggiornare gli avvisi di velocità, devi disporre dell'autorizzazione firebasecrashlytics.config.update. Per impostazione predefinita, i seguenti ruoli includono questa autorizzazione richiesta: Firebase Crashlytics Admin, Firebase Quality Admin, Firebase Admin o Proprietario o Editor del progetto.

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

  1. Nella console Firebase, vai alla dashboard di 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 () e seleziona Impostazioni di avviso sulla 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 Crashlytics avvisi via email. Per gli avvisi sulla velocità e le regressioni, 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 di Crashlytics senza influire sugli altri membri del progetto. Tieni presente che devi comunque disporre delle autorizzazioni richieste per ricevere gli avvisi.

Per attivare o disattivare gli avvisi Crashlytics:

  1. Nella console Firebase, nell'angolo in alto a destra, vai agli avvisi di Firebase.
  2. Quindi, vai a Impostazioni e imposta la preferenza del tuo account per gli avvisi Crashlytics.

Configurare avvisi di base per 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 con richiesta nella scheda Integrazioni nelle Impostazioni progetto.

Tieni presente che se vuoi un maggiore controllo e personalizzazione per l'invio di avvisi a qualsiasi servizio di terze parti (non solo Slack, Jira o PagerDuty), consulta la sezione Configurare avvisi avanzati per i servizi di terze parti che descrive le opzioni di avviso avanzate.

Configurare avvisi avanzati per i 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 in 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 link diretti 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 e accedi all'interfaccia a riga di comando Firebase.
    3. Inizializza Cloud Functions for Firebase utilizzando l'interfaccia a riga di comando Firebase.
  2. Scrivere ed eseguire il deployment di una funzione che acquisisca un evento di avviso da Crashlytics e gestisca il relativo payload (ad esempio, pubblica le informazioni sull'avviso in un messaggio su Discord).

Per informazioni su tutti gli eventi di avviso Crashlytics che puoi acquisire, consulta la documentazione di riferimento per gli avvisi Crashlytics.