Configura avvisi per problemi di prestazioni

Utilizza gli avvisi Performance Monitoring per informare i membri del progetto se le modifiche al codice o le richieste di rete stanno peggiorando il rendimento 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 Firebase console. Gli avvisi vengono attivati solo se la tua app utilizza una versione dell'SDK compatibile con il tempo reale.

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 di rendimento o per le integrazioni configurate nella console Firebase con Slack, Jira o PagerDuty non sono disponibili per gli avvisi di Performance Monitoring.Performance Monitoring

Ricevere avvisi

Ricevere avvisi predefiniti

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

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

• Amministratore di Firebase Performance
• Amministratore della qualità di Firebase
• Amministratore di Firebase
• Proprietario o Editor del progetto

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 di rendimento. Gli avvisi vengono inviati solo ai membri del progetto con le autorizzazioni necessarie per ricevere gli avvisi e ai singoli indirizzi email (non a raggruppamenti di account come i Gruppi Google o gli account Google Workspace).

Attivare/disattivare gli avvisi per il proprio account

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

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

Configurare gli avvisi avanzati per i servizi di terze parti

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

Per configurare le funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase:

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

   1. Configura un ambiente di sviluppo per Node.js o Python.
   2. Installa e accedi alla Firebase CLI.
   3. Inizializza Cloud Functions for Firebase utilizzando la Firebase CLI.

2. Scrivi e implementa una funzione che acquisisce un evento di avviso da Performance Monitoring e gestisce il payload dell'evento (ad esempio, pubblica le informazioni sull'avviso in un messaggio su Discord).

Per scoprire tutti gli eventi di avviso di rendimento 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 è vera 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 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 Aggregare i dati in base ai pattern URL personalizzati.

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

Configurare 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: Amministratore di Firebase Performance, Amministratore della qualità di Firebase, Amministratore di Firebase, e Proprietario o Editor del progetto.

Se non l'hai ancora fatto, aggiungi l'ultima versione dell'SDK Performance Monitoring alla tua app. Per saperne di più, consulta le guide introduttive per le piattaforme web , Android , Apple e Flutter.

In ognuna delle app registrate, 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, ognuno con una soglia diversa (o non avere avvisi).

Configurare un avviso nella tabella Tracce

1. Vai alla scheda Performance Monitoring Dashboard nella console Firebase, quindi seleziona l'app per la quale 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 il quale vuoi impostare un avviso, quindi trova la riga applicabile.

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

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 saperne di più sui percentili predefiniti, consulta Monitorare le metriche chiave nella dashboard.

Configurare un avviso nella scheda report della dashboard

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

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

3. Nella scheda della metrica desiderata, apri il menu Overflow (more_vert) 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 saperne di più sui percentili predefiniti, consulta Monitorare le metriche chiave nella dashboard.

Best practice per l'impostazione di un avviso di rendimento

Richieste di rete

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

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

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

Configurare gli avvisi per i pattern URL personalizzati

Ti consigliamo di configurare gli avvisi per tutti i pattern URL personalizzati che hai configurato. Poiché Firebase tenta di abbinare prima 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.

Configurare gli avvisi per i pattern URL automatici

Quando configuri un avviso per un pattern URL automatico, assicurati che il pattern URL automatico sia stabile da 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 prendere in considerazione la creazione di un pattern URL personalizzato per assicurarti che questo pattern sia stabile.

Caricamenti di pagine web

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

Rendering schermo

Per garantire un'esperienza ottimale dell'app, le sessioni utente non devono contenere frame lenti e bloccati. Performance Monitoring consiglia di configurare gli 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 di rendimento. Per saperne di più sui frame lenti eccessivi o bloccati e su altre best practice per le prestazioni dell'app, consulta le indicazioni di Google Play.