Configura avvisi per problemi di prestazioni

Usa gli avvisi di Performance Monitoring per inviare una notifica ai membri del progetto in caso di modifiche al codice o alla rete di Compute Engine stanno riducendo le prestazioni della tua app.

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

Che cosa attiva l'avviso?

Viene attivato un avviso quando una metrica della tua app supera una soglia indicata definisci un percentile specificato (se applicabile) nella console Firebase. Gli avvisi vengono attivati solo se l'app utilizza un versione dell'SDK compatibile in tempo reale.

ora di inizio dell'app

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

  • Firebase ha registrato almeno 100 campioni di _app_start monitorare l'ultima versione della tua app nell'ultima ora.
  • La durata della traccia _app_start ha superato la soglia definita dall'app nell'ultima ora e per il percentile configurato.
  • Non è stato generato alcun avviso per la stessa soglia nella versione più recente della tua app.
di Gemini Advanced.

tracce di codice personalizzate

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

  • Firebase ha registrato almeno 100 esempi di traccia di codice personalizzata l'ultima versione della tua app nell'ultima ora.
  • La durata della traccia ha superato la soglia definita dall'app durante il periodo nell'ultima ora e per il percentile configurato.
  • (Solo per iOS+ e Android) In precedenza non è stato generato alcun avviso relativo a stessa soglia nell'ultima versione dell'app.
  • (Solo per il web) In precedenza non è stato generato alcun avviso per la stessa soglia negli ultimi 3 giorni.

richieste di rete

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

  • Firebase ha registrato almeno 100 campioni corrispondenti all'URL in tutte le versioni della tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita durante l'ultimo periodo ora:
    • response time: il valore aggregato ha superato la soglia impostata per il percentile configurato
    • percentuale di successo: (solo per iOS+/Android) il valore aggregato è stato inferiore la soglia impostata per tutti gli utenti
  • In passato non è stato generato alcun avviso per la stessa soglia 3 giorni.

rendering dello schermo

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

  • Firebase ha registrato almeno 100 campioni di schermate il rendering per la versione più recente della tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita durante il periodo ultima ora:
    • frame bloccati: il valore aggregato ha superato la soglia impostata
    • frame lenti: il valore aggregato ha superato la soglia impostata
  • Non è stato registrato alcun avviso nell'ultimo periodo per la stessa soglia all'ultima versione dell'app.

caricamenti pagina

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

  • Firebase ha registrato almeno 100 campioni del caricamento della pagina per la tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita durante l'ultimo periodo 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 passato non è stato generato alcun avviso per la stessa soglia 3 giorni.

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

Avvisi per altre metriche sul rendimento o per integrazioni Firebase integrate con Slack Jira e PagerDuty non sono disponibili per gli avvisi Performance Monitoring.

Ricevi avvisi

Ricevere avvisi predefiniti

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

Per ricevere Performance Monitoring avvisi tramite questo meccanismo predefinito, devi disporre del Autorizzazione firebaseperformance.config.update. I seguenti ruoli includono questo per impostazione predefinita:

Gli avvisi e le relative impostazioni sono a livello di progetto. Ciò significa che, per impostazione predefinita, ogni un membro del progetto (che non è un gruppo email e dispone delle autorizzazioni necessarie per ricevere avvisi) riceverà un'email quando viene attivato un avviso relativo alle prestazioni.

Attivare/disattivare gli avvisi per il proprio account

Per il tuo account, puoi attivare/disattivare gli avvisi relativi a Performance Monitoring senza che interessano gli altri membri del progetto. Tieni presente che devi comunque disporre delle autorizzazioni richieste 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 a Firebase avvisi.
  2. Poi vai a Impostazioni e imposta la preferenza del tuo account per Performance Monitoring avvisi.

Configurare avvisi avanzati per i servizi di terze parti

Puoi anche inviare avvisi Performance Monitoring al canale di notifica preferito del tuo team utilizzando Cloud Functions for Firebase. Ad esempio, puoi scrivere un funzione che acquisisce un evento di avviso per l'avvio lento dell'app e pubblica il informazioni sugli avvisi a 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. Configurare 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 lo gestisce (ad esempio, pubblica le informazioni di avviso in un messaggio su Discord).

Per informazioni su tutti gli eventi degli avvisi sul rendimento che puoi acquisire, consulta l' documentazione di riferimento 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 presenti uso attivo. Gli avvisi sono considerati validi se una delle seguenti condizioni è vera:

  • L'avviso viene creato per un ID risorsa per il quale Performance Monitoring ha ricevuto dati negli ultimi 90 giorni.
  • L'avviso è stato creato di recente per un pattern URL personalizzato. Dopo aver creato pattern URL personalizzato e configuri un avviso, hai 90 giorni di tempo per inviare i dati questo schema. Se non vengono inviati dati entro il periodo di 90 giorni, Performance Monitoring per rimuovere l'avviso. Per ulteriori informazioni sui pattern URL personalizzati, consulta Aggrega i dati nei pattern URL dei clienti.

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

Configurare un avviso

Per configurare Performance Monitoring avvisi, devi avere Autorizzazione firebaseperformance.config.update. I seguenti ruoli includono questo per impostazione predefinita: Amministratore Firebase Performance, Amministratore qualità Firebase, Amministratore Firebase, e Proprietario o Editor del progetto.

Se non l'hai ancora fatto, aggiungi l'SDK Performance Monitoring più recente alla tua app. Per saperne di più, consulta le guide per iniziare a utilizzare le piattaforme web, Android, Apple e Flutter.

In ciascuna delle app registrate, utilizza la tabella Tracce. o la scheda del report Dashboard per configurare e un avviso per ogni metrica da monitorare. Ogni app può avere un insieme diverso di avvisi, ognuno con una soglia diversa (o senza avvisi tutti).

Configurare un avviso nella tabella Tracce

  1. Vai alla scheda Performance Monitoring Dashboard nella console Firebase e 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 e trova la riga pertinente.

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

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

Configurare un avviso nella scheda del report Dashboard

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

  2. Nella scheda Scheda report, individua la scheda delle metriche per cui vuoi configurare un avviso.

  3. Nella scheda della metrica desiderata, apri il menu extra () e seleziona Impostazioni avvisi.

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

Best practice per l'impostazione di un avviso sul rendimento

Richieste di rete

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

Configura avvisi per i tuoi pattern URL personalizzati

Ti consigliamo di impostare avvisi per tutti i pattern URL personalizzati che hai configurato. Poiché Firebase tenta di abbinare una richiesta a un pattern URL personalizzato, per prima cosa, le richieste simili vengono mappate in modo più coerente allo stesso pattern URL. In questo modo gli avvisi relativi a pattern URL personalizzati sono più significativi ed efficaci per team, perché hai già identificato lo specifico modello di richieste altrettanto importanti per la tua app.

Configurare gli avvisi per i pattern URL automatici

Quando imposti un avviso per un pattern URL automatico, assicurati che l'URL Il pattern URL si è stabilizzato per alcuni giorni. Tieni presente che gli URL automatici i pattern possono cambiare nel tempo e le configurazioni degli avvisi non vengono trasferite Pattern URL. Ciò potrebbe causare avvisi errati o mancanti per i pattern a cui tieni. Puoi anche valutare la creazione di un pattern URL personalizzato per assicurarti che questo pattern sia stabile.

Caricamenti della pagina web

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

Rendering schermo

Per garantire un'esperienza ottimale con l'app, le sessioni utente devono essere prive di frame lenti e bloccati. Performance Monitoring consiglia di configurare avvisi per i frame bloccati maggiore dell'1% e di aver configurato avvisi per i frame lenti che superano il 5%. Li troverete come impostazioni predefinite durante la configurazione degli avvisi sul rendimento. Per scoprire di più sulla lentezza eccessiva o bloccati e altre best practice relative alle prestazioni dell'app, consulta le indicazioni di Google Play.