Firebase Performance Monitoring Aggrega automaticamente i dati per richieste di rete simili per aiutarti a comprendere le tendenze nel rendimento delle richieste di rete.
A volte, però, devi personalizzare il modo in cui Firebase aggrega dati specifici delle richieste di rete per supportare meglio i casi d'uso della tua app. Forniamo due modi per personalizzare l'aggregazione dei dati per le richieste di rete: aggregare i dati in base a pattern URL personalizzati e personalizzare il modo in cui viene calcolata la percentuale di successo.
Aggrega i dati in base a pattern URL personalizzati
Per ogni richiesta, Firebase controlla se l'URL della richiesta di rete corrisponde a un pattern URL. Se l'URL della richiesta corrisponde a un pattern URL, Firebase aggrega automaticamente i dati della richiesta in base al pattern URL.
Puoi creare pattern URL personalizzati per monitorare pattern URL specifici che Firebase non acquisisce con la corrispondenza automatica dei pattern URL. Ad esempio, puoi utilizzare un pattern URL personalizzato per risolvere i problemi relativi a un URL specifico o per monitorare un insieme specifico di URL nel tempo.
Firebase mostra tutti i pattern URL (inclusi quelli personalizzati) e i relativi dati aggregati nella scheda secondaria Richieste di rete della tabella delle tracce, che si trova in fondo alla dashboard Rendimento della console Firebase.
Come funziona la corrispondenza dei pattern URL personalizzati?
Firebase tenta di trovare una corrispondenza tra gli URL delle richieste e i pattern URL personalizzati configurati prima di ricorrere alla corrispondenza automatica dei pattern URL. Per tutte le richieste corrispondenti a un pattern URL personalizzato, Firebase aggrega i dati delle richieste nel pattern URL personalizzato.
Se l'URL di una richiesta corrisponde a più di un pattern URL personalizzato, Firebase mappa la richiesta solo al pattern URL personalizzato più specifico, in base al seguente ordine di specificità: testo normale > * > ** da sinistra a destra nel percorso. Ad esempio, una richiesta a example.com/books/dog corrisponde
a due pattern URL personalizzati:
example.com/books/*example.com/*/dog
Tuttavia, il pattern
example.com/books/* è il pattern URL corrispondente più specifico perché il
segmento più a sinistra books in example.com/books/* ha la precedenza sul
segmento più a sinistra * in example.com/*/dog.
Quando crei un nuovo pattern URL personalizzato, tieni presente quanto segue:
Le corrispondenze e i dati aggregati delle richieste precedenti non sono interessati dalla creazione di un nuovo pattern URL personalizzato. Firebase non riaggrega retroattivamente i dati delle richieste.
Solo le richieste future sono interessate dalla creazione di un nuovo pattern URL personalizzato. Potresti dover attendere fino a 12 ore prima che Performance Monitoring raccolga e aggreghi i dati in base a un nuovo pattern URL personalizzato.
Crea un pattern URL personalizzato
Puoi creare un pattern URL personalizzato dalla scheda secondaria Richieste di rete nella tabella delle tracce, che si trova nella parte inferiore della dashboard Rendimento della console Firebase.
Un membro del progetto deve essere un proprietario o un editor per creare un nuovo pattern URL personalizzato. Tuttavia, tutti i membri del progetto possono visualizzare i pattern URL personalizzati e i relativi dati aggregati.
Puoi creare fino a 400 pattern URL personalizzati totali per app e fino a 100 pattern URL personalizzati per dominio per l'app.
Per creare un pattern URL personalizzato, inizia con un nome host, seguito dai segmenti di percorso. Il nome host deve includere un dominio valido e può includere facoltativamente il sottodominio. Utilizza la seguente sintassi dei segmenti di percorso per creare un pattern che possa corrispondere agli URL.
- testo normale: corrisponde a una stringa esatta
*: corrisponde al primo segmento del sottodominio o a qualsiasi stringa in un singolo segmento del percorso**: corrisponde a un suffisso di percorso arbitrario
La seguente tabella descrive alcune potenziali corrispondenze dei pattern URL personalizzati.
| Per abbinare… | Crea un pattern URL personalizzato come… | Esempi di corrispondenze con questo pattern di URL |
|---|---|---|
| Un URL esatto | example.com/foo/baz |
example.com/foo/baz
|
Qualsiasi singolo segmento di percorso (*) |
example.com/*/baz |
example.com/foo/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
Nota:questo pattern non corrisponderà a
|
|
Un suffisso di percorso arbitrario (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
Il primo segmento del sottodominio (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Visualizzare i pattern URL personalizzati e i relativi dati
Firebase mostra tutti i pattern URL (inclusi quelli personalizzati) e i relativi dati aggregati nella scheda secondaria Richieste di rete della tabella delle tracce, che si trova in fondo alla dashboard Rendimento della console Firebase.
Per visualizzare solo i pattern URL personalizzati, seleziona Pattern personalizzati dal menu a discesa nella scheda secondaria Richieste di rete della tabella delle tracce. Tieni presente che se un pattern URL personalizzato non ha dati aggregati, viene visualizzato solo in questo elenco.
Al termine del periodo di conservazione dei dati per i dati aggregati in base a un pattern URL, Firebase elimina questi dati dal pattern URL. Se tutti i dati aggregati in un pattern URL personalizzato scadono, Firebase non elimina il pattern URL personalizzato dalla console Firebase. Firebase continua invece a elencare i pattern URL personalizzati "vuoti" nell'elenco Pattern personalizzati della scheda secondaria Richieste di rete della tabella delle tracce.
Rimuovere un pattern URL personalizzato
Puoi rimuovere i pattern URL personalizzati dal tuo progetto. Tieni presente che non puoi rimuovere un pattern URL automatico.
Nella dashboard Rendimento, scorri verso il basso fino alla tabella delle tracce, quindi seleziona la scheda secondaria Richieste di rete.
Seleziona Pattern personalizzati dal menu a discesa nella scheda secondaria Richieste di rete.
Passa il mouse sopra la riga del pattern URL personalizzato che vuoi rimuovere.
Fai clic su all'estrema destra della riga, seleziona Rimuovi pattern personalizzato, quindi conferma la rimozione nella finestra di dialogo.
Quando rimuovi un pattern URL personalizzato, tieni presente quanto segue:
Le richieste future vengono mappate al pattern URL personalizzato corrispondente più specifico. Se Firebase non trova pattern URL personalizzati corrispondenti, viene eseguita la corrispondenza automatica dei pattern URL.
Le corrispondenze e i dati aggregati delle richieste precedenti non sono interessati dalla rimozione di un pattern URL personalizzato.
Puoi comunque accedere a un pattern URL personalizzato rimosso e ai relativi dati aggregati nella scheda secondaria Richieste di rete (con l'opzione Tutte le richieste di rete selezionata) fino al termine del periodo di conservazione dei dati applicabile. Quando tutti i dati aggregati nel pattern URL personalizzato rimosso scadono, Firebase elimina il pattern URL personalizzato.
La scheda secondaria Richieste di rete (con Pattern personalizzati selezionato) non elenca i pattern URL personalizzati rimossi.
Passaggi successivi
- Configura avvisi per le richieste di rete che peggiorano il rendimento della tua app. Ad esempio, puoi configurare un avviso via email per il tuo team se il tempo di risposta per un pattern URL specifico supera una soglia che hai impostato.
Personalizzare il calcolo della percentuale di successo
Una delle metriche monitorate da Firebase per ogni richiesta di rete è la percentuale di successo della richiesta. La percentuale di successo è la percentuale di risposte riuscite rispetto al totale delle risposte. Questa metrica consente di misurare gli errori di rete e del server.
Nello specifico, Firebase conteggia automaticamente le richieste di rete con un codice di risposta nell'intervallo 100-399 come risposte riuscite.
Puoi personalizzare il calcolo della percentuale di successo conteggiando determinati codici di errore come "risposte riuscite" oltre ai codici di risposta che Firebase conteggia automaticamente come riuscite.
Ad esempio, se la tua app ha un'API endpoint di ricerca, puoi considerare le risposte 404 come "riuscita" perché le risposte 404 sono previste per un endpoint di ricerca. Supponiamo che per questo endpoint di ricerca ci siano 100 campioni ogni ora e che 60 di questi siano risposte 200 e 40 siano risposte 404. Prima di configurare la percentuale di successo, questa sarà del 60%. Dopo aver configurato il calcolo della percentuale di successo in modo da conteggiare le risposte 404 come riuscite, la percentuale di successo sarà del 100%.
Configurare il calcolo della percentuale di successo
Per configurare il calcolo della percentuale di successo per un pattern URL di rete, devi
disporre dell'autorizzazione firebaseperformance.config.update. I seguenti ruoli
includono questa autorizzazione obbligatoria per impostazione predefinita:
Amministratore Firebase Performance,
Amministratore Firebase Quality,
Amministratore Firebase
e Proprietario o Editor del progetto.
- Vai alla scheda Dashboard in Performance Monitoring console, quindi seleziona l'app per cui vuoi configurare un calcolo del tasso di successo.Firebase
- Scorri verso il basso fino alla tabella delle tracce nella parte inferiore dello schermo e seleziona la scheda Richieste di rete.
- Trova il pattern URL per il quale vuoi configurare il calcolo della percentuale di successo.
- All'estrema destra della riga, apri il menu di overflow () e seleziona Configura tasso di successo.
- Segui le istruzioni sullo schermo per selezionare i codici di risposta che vuoi conteggiare come codici di risposta riusciti.