Configurare e inviare avvisi personalizzati a canali di notifica personalizzati

Firebase offre avvisi Crashlytics predefiniti (vedi la pagina di panoramica 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 un criterio di avviso, che descrive le circostanze in cui vuoi ricevere avvisi e come vuoi ricevere le notifiche.

Ad esempio, se il tasso di assenza di 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 link diretti utili alla console Firebase o informazioni per la risoluzione dei problemi specifiche per l'azienda.

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

Prerequisiti

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

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

3. Configura i canali di notifica.

Configura un criterio di avviso

Di seguito sono riportate le istruzioni di alto livello. Per istruzioni dettagliate, consulta la documentazione di Google Cloud (ad esempio, Creare policy di avviso basate su soglie metriche o Utilizzare PromQL per creare policy di avviso).

Nell'ambito dell'esecuzione delle query, puoi configurare un avviso basato sui 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 visualizzato.

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

• Configura un avviso basato su SQL:

  1. Esegui una query in Analisi dei log.

  2. Fai clic sul pulsante Aggiungi avviso 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 sui log utilizzando lo strumento di configurazione delle policy nella console Google Cloud, dove puoi scegliere una delle seguenti opzioni:

• Generatore: L'interfaccia utente della console fornisce un flusso di lavoro guidato per creare il criterio di avviso.

• PromQL: Fornisci una query PromQL per la policy di avviso.

  Query PromQL di esempio

  Ad esempio, supponi di aver creato due metriche basate sui log per i dati delle sessioni di Crashlytics e Firebase esportati:

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

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

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

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

  Ecco un esempio di query PromQL che utilizza queste metriche basate sui log per generare un avviso quando il tasso di 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