Configurare avvisi avanzati per canali di notifica personalizzati

Firebase offre due opzioni per configurare gli avvisi e inviarli a canali di notifica personalizzati.

• (Consigliato) Configura e invia avvisi personalizzati a canali di notifica personalizzati

  Puoi utilizzare Cloud Monitoring per inviare avvisi personalizzati a canali di notifica personalizzati in base ai dati di Crashlytics e (facoltativamente) ai dati delle sessioni Firebase che hai esportato in Cloud Logging.

• Invia avvisi Crashlytics predefiniti ai canali di notifica personalizzati

  Puoi utilizzare Cloud Functions per inviare gli avvisi Crashlytics predefiniti ai canali di notifica personalizzati.

---

(Consigliato) Configura e invia avvisi personalizzati a canali di notifica personalizzati

Firebase offre avvisi Crashlytics predefiniti (consulta la pagina di riepilogo degli avvisi). Tuttavia, questi avvisi predefiniti e i relativi canali di notifica potrebbero non essere sufficienti per le tue esigenze.

In questi casi, puoi utilizzare Cloud Monitoring per inviare avvisi personalizzati a canali di notifica personalizzati in base ai dati di Crashlytics (e facoltativamente ai dati delle sessioni Firebase) che hai esportato in Cloud Logging.

Per utilizzare Cloud Monitoring per gli avvisi personalizzati, configura una policy di avviso, che descrive le circostanze in cui vuoi ricevere un avviso e come vuoi ricevere la notifica.

Ad esempio, se il tasso di utenti senza arresti anomali scende al di sotto di una soglia specifica, Cloud Monitoring può inviare un messaggio di avviso personalizzato a un indirizzo email specifico o pubblicarlo su un servizio di terze parti, come Discord, Slack o Jira. Puoi anche personalizzare completamente le informazioni inviate nell'avviso, ad esempio includendo deep link utili alla console Firebase o informazioni per la risoluzione dei problemi specifiche dell'azienda.

Nella documentazione di Google Cloud, scopri di più su Cloud Monitoring e sugli avvisi, tra cui i prezzi.

Prerequisiti

1. Assicurati che il tuo progetto Firebase sia nel piano tariffario Blaze con pagamento a consumo.

2. Configura l'esportazione in Cloud Logging dei dati di Crashlytics e, facoltativamente, dei dati delle sessioni Firebase.

3. Configura i canali di notifica.

Configura una policy di avviso

Di seguito sono riportate istruzioni generali. Per istruzioni dettagliate, consulta la documentazione di Google Cloud (ad esempio: Crea policy di avviso basate su soglie metriche o Utilizza PromQL per creare policy di avviso).

Nell'ambito dell'esecuzione delle query, puoi configurare un avviso basato su log o un avviso basato su SQL:

• Configura un avviso basato su log:

  1. Esegui una query in Logs Explorer.

  2. Fai clic sul pulsante Aggiungi avviso che viene visualizzato.

  3. Segui le istruzioni sullo schermo per aggiungere un avviso basato su log.

• Configura un avviso basato su SQL:

  1. Esegui una query in Analisi dei log.

  2. Fai clic sul pulsante Aggiungi avviso che viene visualizzato.

  3. Segui le istruzioni sullo schermo per aggiungere un avviso basato su SQL.

In alternativa, puoi configurare gli avvisi per le tue metriche basate su log utilizzando lo strumento di configurazione delle policy nella console Google Cloud, dove puoi scegliere una delle seguenti opzioni:

• Builder: la UI della console fornisce un flusso di lavoro guidato per creare la policy di avviso.

• PromQL: fornisci una query PromQL per la policy di avviso

  Query PromQL di esempio

  Ad esempio, supponiamo che tu abbia creato due metriche basate su log per i dati esportati delle sessioni di Crashlytics e Firebase:

  • Una metrica denominata firebase/crashlytics_events con un'etichetta errorType, definita come:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Un'altra metrica denominata firebase/session_events con un'etichetta eventType, definita come:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Ecco un esempio di query PromQL che utilizza queste metriche basate su log per generare un avviso quando la percentuale di sessioni senza arresti anomali scende al di sotto del 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7

---

Invia avvisi Crashlytics predefiniti a canali di notifica personalizzati

Firebase offre avvisi Crashlytics predefiniti (consulta l'elenco nella pagina di riepilogo delle opzioni di avviso). Tuttavia, le informazioni contenute in questi avvisi predefiniti e i relativi canali di notifica potrebbero non essere sufficienti per le tue esigenze.

In questi casi, puoi utilizzare Cloud Functions for Firebase per inviare questi avvisi Crashlytics predefiniti a canali di notifica personalizzati. 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 anche personalizzare le informazioni inviate al servizio di terze parti. Ad esempio, oltre alle informazioni predefinite fornite da Firebase, puoi includere anche deep link utili alla console Firebase o informazioni per la risoluzione dei problemi specifiche dell'azienda.

Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase, segui questi passaggi:

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

   1. Configura un ambiente di sviluppo per Node.js o Python.
   2. Installa l'interfaccia a riga di comando Firebase e accedi.
   3. Inizializza Cloud Functions for Firebase utilizzando l'interfaccia a riga di comando di 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 dell'avviso in un messaggio su Discord).

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

Scopri di più sulla gestione degli avvisi di Crashlytics utilizzando Cloud Functions for Firebase