Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Imposta avvisi per problemi di prestazioni

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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

Puoi impostare e personalizzare gli avvisi per la tua app, che ti avvisano quando le prestazioni di un evento superano una soglia prestabilita.

Cosa attiva un avviso?

Viene attivato un avviso quando una metrica per la tua app supera una soglia definita per un percentile specificato (se applicabile) nella console Firebase. Gli avvisi vengono attivati ​​solo se la tua app utilizza una versione 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 durante l'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 si configura un avviso per una metrica di traccia del codice personalizzata, 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 durante l'ultima ora e per il percentile configurato.
  • (Solo per iOS+ e Android) Non è stato generato alcun avviso in precedenza 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 si configura un avviso per una metrica di richiesta di rete, l'avviso viene attivato se tutte le seguenti condizioni sono vere:

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

resa dello schermo

Quando si configura 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 esempi di rendering dello schermo per l'ultima versione della tua app nell'ultima ora.
  • Il valore aggregato della metrica ha superato la soglia definita durante l'ultima ora:
    • frames congelati : 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 di pagina

Quando configuri un avviso per una metrica di caricamento della pagina, l'avviso viene attivato se 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'ultima ora e per il percentile configurato:
    • ritardo primo ingresso : 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
  • Non è stato generato alcun avviso in precedenza per la stessa soglia negli ultimi 3 giorni .

Ulteriori informazioni sulla configurazione di avvisi , percentili predefiniti e best practice per l'impostazione di avvisi per tipi specifici di tracce e metriche.

Gli avvisi per altre metriche delle prestazioni o per le integrazioni Firebase integrate con Slack , Jira e PagerDuty non sono disponibili per gli avvisi di monitoraggio delle prestazioni.

Ricevi avvisi

Ricevi avvisi predefiniti

Per impostazione predefinita, Firebase può inviare avvisi di monitoraggio delle prestazioni tramite e-mail.

Per ricevere avvisi di monitoraggio delle prestazioni tramite questo meccanismo predefinito, è necessario disporre dell'autorizzazione firebaseperformance.config.update . I seguenti ruoli includono questa autorizzazione richiesta per impostazione predefinita:

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

Attiva/disattiva gli avvisi per il tuo account

Per il tuo account, puoi attivare/disattivare gli avvisi di monitoraggio delle prestazioni senza influire sugli altri membri del progetto. Tieni presente che hai ancora bisogno delle autorizzazioni necessarie per ricevere gli avvisi.

Per attivare o disattivare gli avvisi di Monitoraggio delle prestazioni, procedi nel seguente modo:

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

Imposta avvisi avanzati per servizi di terze parti

Puoi anche inviare avvisi di monitoraggio delle prestazioni al canale di notifica preferito del tuo team, utilizzando Cloud Functions per Firebase. Ad esempio, puoi scrivere una funzione che acquisisca un evento di avviso per l'ora di avvio lenta dell'app e pubblichi le informazioni sull'avviso a un servizio di terze parti, come Discord, Slack o Jira.

Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions per Firebase, procedi nel seguente modo:

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

    1. Scarica Node.js e npm.
    2. Installa e accedi all'interfaccia a riga di comando di Firebase.
    3. Inizializza Cloud Functions per Firebase utilizzando l'interfaccia a riga di comando di Firebase.
  2. Scrivi e distribuisci una funzione che catturi un evento di avviso dal monitoraggio delle prestazioni e gestisca il payload dell'evento (ad esempio, pubblica le informazioni sull'avviso in un messaggio su Discord).

Per informazioni su tutti gli eventi di avviso sulle prestazioni che puoi acquisire, consulta la documentazione di riferimento per gli avvisi di monitoraggio delle prestazioni .

Rimozione automatica degli avvisi non validi

Il monitoraggio delle prestazioni 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 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 un pattern URL personalizzato e impostato un avviso, hai 90 giorni di tempo per inviare i dati per quel pattern. Se non vengono inviati dati entro il periodo di 90 giorni, il monitoraggio delle prestazioni rimuove l'avviso. Per ulteriori informazioni sui pattern URL personalizzati, consulta Aggregare i dati nei pattern URL dei clienti .

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

Configura un avviso

Per configurare gli avvisi di monitoraggio delle prestazioni, è necessario 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 Project Owner o Editor .

Se non l'hai già fatto, aggiungi l'SDK di monitoraggio delle prestazioni più recente alla tua app. Per ulteriori informazioni, consulta le guide introduttive per le piattaforme Web , Android , Apple e Flutter .

In ciascuna delle tue app registrate, utilizza la tabella Traces o la pagella del dashboard per configurare un avviso per ogni parametro che desideri monitorare. Ogni app può avere un diverso set di avvisi, ciascuno con una soglia diversa (o non avere alcun avviso).

Configurare un avviso nella tabella Traces

  1. Vai alla scheda Dashboard di monitoraggio delle prestazioni nella console Firebase, quindi seleziona l'app per la quale desideri configurare un avviso.

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

  3. Selezionare la scheda del tipo di traccia per il quale si desidera impostare un avviso, quindi individuare 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 il 90° per Android e iOS e il 75° per il Web. Per ulteriori informazioni sui percentili predefiniti, consulta Tenere traccia delle metriche chiave nella dashboard .

Configura un avviso nella pagella di Dashboard

  1. Vai alla scheda Dashboard di monitoraggio delle prestazioni nella console Firebase, quindi seleziona l'app per la quale desideri configurare un avviso.

  2. Nella scheda Report card, individuare la scheda metrica per la quale si desidera configurare un avviso.

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

  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 il 90° per Android e iOS e il 75° per il Web. Per ulteriori informazioni sui percentili predefiniti, consulta Tenere traccia delle metriche chiave nella dashboard .

Best practice per l'impostazione di un avviso sulle prestazioni

Richieste di rete

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

  • Pattern definiti dall'utente, chiamati pattern URL personalizzati .

  • Pattern derivati ​​da Firebase, chiamati pattern URL automatici .
    Questi modelli possono cambiare nel tempo in base al comportamento di utilizzo più recente della tua app.

Imposta avvisi per i tuoi pattern URL personalizzati

Ti consigliamo di impostare avvisi per qualsiasi pattern URL personalizzato che hai configurato. Poiché Firebase tenta prima di abbinare una richiesta a un pattern URL personalizzato, le richieste simili vengono mappate in modo più coerente allo stesso pattern URL. Ciò rende gli avvisi per un pattern URL personalizzato più significativi ed efficaci per il tuo team, perché hai già identificato quel pattern specifico di richieste come importante per la tua app.

Imposta avvisi per pattern URL automatici

Quando imposti 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 modelli che ti interessano. Puoi anche prendere in considerazione la creazione di un pattern URL personalizzato per assicurarti che questo pattern sia stabile.

La pagina Web viene caricata

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

Rendering dello schermo

Per garantire un'esperienza ottimale dell'app, le sessioni utente devono essere prive di frame lenti e congelati. Performance Monitoring consiglia di impostare avvisi per frame bloccati superiori all'1% e di impostare avvisi per frame lenti superiori al 5%. Scoprirai che questi valori sono presenti come impostazioni predefinite durante la configurazione degli avvisi sulle prestazioni. Per ulteriori informazioni sui frame eccessivamente lenti o bloccati e su altre best practice per le prestazioni delle app, consulta la guida di Google Play .