Configura avvisi per problemi di prestazioni

Utilizza gli avvisi di Performance Monitoring per informare i membri del progetto se le modifiche al codice o le richieste di rete stanno peggiorando le prestazioni della tua app.

Puoi configurare e personalizzare gli avvisi per la tua app, che ti informano quando il rendimento di un evento supera una soglia impostata.

Cosa attiva un avviso?

Un avviso viene attivato quando una metrica della tua app supera una soglia che hai definito per un percentile specificato (se applicabile) nella console Firebase. Gli avvisi vengono attivati solo se la tua app utilizza una versione dell'SDK compatibile in tempo reale.

ora di inizio dell'app

Quando configuri un avviso per l'ora di inizio dell'app, l'avviso viene attivato se tutte le seguenti condizioni sono vere:

  • Firebase ha registrato almeno 100 campioni della traccia _app_start per l'ultima versione della tua app nell'ultima ora.
  • La durata della traccia _app_start ha superato la soglia definita dell'app nell'ultima ora e per il percentile configurato.
  • Non è stato generato alcun avviso in precedenza per la stessa soglia nell'ultima versione dell'app.

tracce di codice personalizzato

Quando configuri un avviso per una metrica di traccia del codice personalizzato, l'avviso viene attivato se tutte le seguenti condizioni sono vere:

  • Firebase ha registrato almeno 100 campioni della traccia del codice personalizzato per l'ultima versione della tua app nell'ultima ora.
  • La durata della traccia ha superato la soglia definita dell'app nell'ultima ora e per il percentile configurato.
  • (Solo per iOS+ e Android) In precedenza non è stato generato alcun avviso per la stessa soglia nell'ultima versione dell'app.
  • (Solo per il web) Non è stato generato alcun avviso in precedenza per la stessa soglia negli ultimi 3 giorni.

richieste di rete

Quando configuri un avviso per una metrica di richiesta di rete, l'avviso viene attivato se sono vere tutte le seguenti condizioni:

  • Firebase ha registrato almeno 100 campioni corrispondenti al pattern dell'URL in tutte le versioni della tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita nell'ultima ora:
    • tempo di risposta: il valore aggregato ha superato la soglia impostata per il percentile configurato
    • tasso di successo: (solo per iOS+/Android) il valore aggregato è sceso al di sotto della soglia impostata per tutti gli utenti
  • In precedenza non è stato generato alcun avviso per la stessa soglia negli ultimi 3 giorni.

rendering dello schermo

Quando configuri un avviso per una metrica di rendering dello schermo, l'avviso viene attivato se tutte le seguenti condizioni sono vere:

  • Firebase ha registrato almeno 100 campioni di rendering dello schermo per l'ultima versione della tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita nell'ultima ora:
    • Frame bloccati: il valore aggregato ha superato la soglia impostata
    • Frame lenti: il valore aggregato ha superato la soglia impostata.
  • Non è stato generato alcun avviso in precedenza per la stessa soglia nell'ultima versione dell'app.

caricamenti pagina

Quando configuri un avviso per una metrica di caricamento pagina, l'avviso viene attivato se sono soddisfatte tutte le seguenti condizioni:

  • Firebase ha registrato almeno 100 campioni di caricamento pagina per la tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita nell'ultima ora e per il percentile configurato:
    • first input delay: il valore aggregato ha superato la soglia impostata e il percentile configurato
    • first contentful paint: il valore aggregato ha superato la soglia impostata e il percentile configurato
    • first paint: il valore aggregato ha superato la soglia impostata e il percentile configurato
  • In precedenza non è stato generato alcun avviso per la stessa soglia negli ultimi 3 giorni.

Scopri di più sulla configurazione degli avvisi, sui percentili predefiniti e sulle best practice per la configurazione degli avvisi per tipi specifici di tracce e metriche.

Gli avvisi per altre metriche sul rendimento o per le integrazioni configurate nella console Firebase con Slack, Jira o PagerDuty non sono disponibili per gli avvisi di Performance Monitoring.

Ricevi avvisi

Ricevi avvisi predefiniti

Per impostazione predefinita, Firebase può inviare avvisi di Performance Monitoring via email.

Per ricevere gli avvisi di Performance Monitoring tramite questo meccanismo predefinito, devi disporre dell'autorizzazione firebaseperformance.config.update. I seguenti ruoli includono questa autorizzazione obbligatoria per impostazione predefinita:

Gli avvisi e le relative impostazioni sono a livello di progetto. Ciò significa che, per impostazione predefinita, ogni membro del progetto riceverà un'email quando viene attivato un avviso relativo alle prestazioni. Gli avvisi vengono inviati solo ai membri del progetto con le autorizzazioni necessarie per ricevere avvisi e a singoli indirizzi email (non a raggruppamenti di account come Google Gruppi o account Google Workspace).

Attiva/disattiva gli avvisi per il tuo account

Per il tuo account, puoi attivare/disattivare gli avvisi di Performance Monitoring 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 di Performance Monitoring, segui questi passaggi:

  1. Nella console Firebase, nell'angolo in alto a destra, vai ad Avvisi Firebase.
  2. Poi, vai a Impostazioni e imposta la preferenza dell'account per gli avvisi di Performance Monitoring.

Configura gli avvisi avanzati per i servizi di terze parti

Puoi anche inviare avvisi di Performance Monitoring 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 un tempo di avvio dell'app lento e pubblica le informazioni sull'avviso in un servizio di terze parti, come Discord, Slack o Jira.

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

  2. Scrivi ed esegui il deployment di una funzione che acquisisce un evento di avviso da Performance Monitoring 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 relativi alle prestazioni che puoi acquisire, consulta la documentazione di riferimento per gli avvisi di Performance Monitoring.

Rimozione automatica degli avvisi non validi

Performance Monitoring convalida gli avvisi per garantire che i dati siano validi e che gli avvisi siano in uso attivo. Gli avvisi sono considerati validi se si verifica una delle seguenti condizioni:

  • L'avviso viene creato per un ID risorsa per cui Performance Monitoring ha ricevuto dati negli ultimi 90 giorni.
  • L'avviso è stato creato di recente per un pattern URL personalizzato. Dopo aver creato un pattern URL personalizzato e configurato un avviso, hai 90 giorni di tempo per inviare i dati per quel pattern. Se non vengono inviati dati entro il periodo di tempo di 90 giorni, Performance Monitoring rimuove l'avviso. Per saperne di più sui pattern URL personalizzati, consulta Aggrega i dati in base ai pattern URL dei clienti.

Se una di queste condizioni non è soddisfatta, Performance Monitoring rimuove l'avviso.

Configura un avviso

Per configurare gli avvisi Performance Monitoring, devi disporre dell'autorizzazione firebaseperformance.config.update. I seguenti ruoli includono questa autorizzazione obbligatoria per impostazione predefinita: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin e Proprietario o Editor del progetto.

Se non l'hai ancora fatto, aggiungi l'SDK Performance Monitoring più recente alla tua app. Per ulteriori informazioni, consulta le guide introduttive per le piattaforme web, Android, Apple e Flutter.

In ogni app registrata, utilizza la tabella Tracce o la scheda report della dashboard per configurare un avviso per ogni metrica che vuoi monitorare. Ogni app può avere un insieme diverso di avvisi, ciascuno con una soglia diversa (o non avere alcun avviso).

Configura un avviso nella tabella Tracce

  1. Vai alla scheda Performance Monitoring Dashboard nella console Firebase, quindi seleziona l'app per cui vuoi configurare un avviso.

  2. Scorri verso il basso fino alla tabella Tracce nella parte inferiore dello schermo.

  3. Seleziona la scheda del tipo di traccia per cui vuoi impostare un avviso, quindi trova la riga applicabile.

  4. All'estrema destra della riga, apri il menu extra () e seleziona Impostazioni avvisi.

  5. Segui le istruzioni sullo schermo per impostare la soglia di avviso e il percentile (se applicabile) per l'app o per attivare/disattivare l'avviso. I percentili predefiniti sono 90° per Android e iOS e 75° per il web. Per scoprire di più sui percentili predefiniti, consulta Monitora le metriche chiave nella dashboard.

Configura un avviso nella scheda del report della dashboard

  1. Vai alla scheda Performance Monitoring Dashboard nella console Firebase, quindi seleziona l'app per cui vuoi configurare un avviso.

  2. Nella scheda Prospetto, individua la scheda della metrica per la quale vuoi configurare un avviso.

  3. Nella scheda della metrica che ti interessa, apri il menu extra () e seleziona Impostazioni avviso.

  4. Segui le istruzioni sullo schermo per impostare la soglia di avviso e il percentile (se applicabile) per l'app o per attivare/disattivare l'avviso. I percentili predefiniti sono 90° per Android e iOS e 75° per il web. Per scoprire di più sui percentili predefiniti, consulta Monitora le metriche chiave nella dashboard.

Best practice per l'impostazione di un avviso relativo alle prestazioni

Richieste di rete

Firebase aggrega i dati di richieste di rete simili in pattern URL, che possono essere:

Configura gli avvisi per i pattern URL personalizzati

Ti consigliamo di configurare avvisi per tutti i pattern URL personalizzati che hai configurato. Poiché Firebase tenta prima di far corrispondere una richiesta a un pattern URL personalizzato, le richieste simili vengono mappate in modo più coerente allo stesso pattern URL. In questo modo, gli avvisi per un pattern URL personalizzato sono più significativi ed efficaci per il tuo team, perché hai già identificato quel pattern specifico di richieste come importante per la tua app.

Configura gli avvisi per i pattern URL automatici

Quando configuri un avviso per un pattern URL automatico, assicurati che il pattern URL automatico si sia stabilizzato per alcuni giorni. Tieni presente che i pattern URL automatici possono cambiare nel tempo e le configurazioni degli avvisi non vengono trasferite ai nuovi pattern URL. Ciò potrebbe comportare avvisi errati o mancanti per i pattern che ti interessano. Puoi anche valutare la possibilità di creare un pattern URL personalizzato per assicurarti che sia stabile.

Caricamenti di pagine web

Per conoscere le soglie consigliate per la misurazione delle metriche web, consulta la documentazione di Core Web Vitals.

Rendering dello schermo

Per garantire un'esperienza con l'app ottimale, le sessioni utente non devono contenere frame lenti e bloccati. Performance Monitoring consiglia di configurare avvisi per i frame bloccati superiori all'1% e per i frame lenti superiori al 5%. Questi valori sono presenti come impostazioni predefinite durante la configurazione degli avvisi relativi alle prestazioni. Per scoprire di più sui frame lenti o bloccati eccessivi e su altre best practice per le prestazioni delle app, consulta le indicazioni di Google Play.