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ò, è necessario personalizzare il modo in cui Firebase aggrega i dati specifici per supportare meglio i casi d'uso della tua app. Forniamo due modi per personalizzare l'aggregazione dei dati per le richieste di rete: aggrega i dati in base a pattern URL personalizzati e personalizza il calcolo della percentuale di successo.
Aggrega i dati in pattern URL personalizzati
Per ogni richiesta, Firebase controlla se l'URL della richiesta di rete corrisponde a una Pattern URL. Se l'URL della richiesta corrisponde a un pattern URL, Firebase aggrega automaticamente i dati della richiesta nel pattern URL.
Puoi creare pattern URL personalizzati per monitorare pattern URL specifici che Firebase non sta acquisendo con il suo pattern URL automatico derivato corrispondenza. 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 visualizza tutti i pattern URL (inclusi i pattern URL personalizzati) e i relativi dati aggregati nella scheda secondaria Richieste di rete della tabella delle tracce, in fondo alla Dashboard del rendimento della console Firebase.
Come funziona la corrispondenza dei pattern URL personalizzati?
Firebase tenta di abbinare gli URL delle richieste a qualsiasi pattern URL personalizzato configurato prima di ricorrere alla corrispondenza automatica dei pattern URL. Per eventuali richieste con corrispondenza in un pattern URL personalizzato, Firebase aggrega le richieste i dati nel bucket Pattern URL.
Se l'URL di una richiesta corrisponde a più pattern URL personalizzati, Firebase mappa la
invia la richiesta solo al pattern URL personalizzato più specifico, in base alla
seguente ordine di specificità: testo normale > * > ** da sinistra a
direttamente all'inizio del 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 su
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 creando un nuovo pattern URL personalizzato. Firebase non aggrega nuovamente i dati delle richieste in modo retroattivo.
La creazione di un nuovo pattern URL personalizzato influisce solo sulle richieste future. Potresti dover attendere fino a 12 ore prima che Performance Monitoring raccolga la raccolta aggregare i dati in un nuovo pattern URL personalizzato.
Crea un pattern URL personalizzato
Puoi creare un pattern URL personalizzato dalla sottoscheda 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; ma tutti i membri del progetto possono visualizzare Pattern URL e relativi dati aggregati.
Puoi creare fino a 400 pattern URL personalizzati per app e fino a 100 pattern URL personalizzati per dominio per quell'app.
Per creare un pattern URL personalizzato, inizia con un nome host, seguito dal percorso segmenti. Il nome host deve includere un dominio valido e può includere facoltativamente il sottodominio. Utilizza la seguente sintassi per i segmenti di percorso per creare un pattern che possono corrispondere agli URL.
- testo normale: corrisponde a una stringa esatta
*: corrisponde al primo segmento di sottodominio o a qualsiasi stringa in un singolo segmento di percorso**: corrisponde a un suffisso di percorso arbitrario
La seguente tabella descrive alcune potenziali corrispondenze di pattern URL personalizzati.
| Per abbinare... | Crea un pattern URL personalizzato come... | L'esempio corrisponde a questo pattern URL |
|---|---|---|
| Un URL esatto | example.com/foo/baz |
example.com/foo/baz
|
Qualsiasi segmento di percorso singolo (*) |
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à
|
|
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 di sottodominio (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Visualizzare pattern URL personalizzati e relativi dati
Firebase visualizza tutti i pattern URL (inclusi i pattern URL personalizzati) e i relativi dati aggregati nella scheda secondaria Richieste di rete della tabella delle tracce, in fondo alla Dashboard del 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 contiene dati aggregati, viene visualizzato solo in questo elenco.
Quando il periodo di conservazione dei dati termina per i dati aggregati in un pattern URL, Firebase elimina questi dati dal pattern URL. Se tutti i dati vengono aggregati sotto un pattern URL personalizzato scade, Firebase non elimina il pattern URL personalizzato dalla Console Firebase. Firebase continua invece a riportare l'elenco "vuoto" URL personalizzato di pattern nell'elenco Pattern personalizzati della scheda Richieste di rete della .
Rimuovere un pattern URL personalizzato
Puoi rimuovere pattern URL personalizzati dal tuo progetto. Tieni presente che non puoi rimuovere un pattern URL automatico.
Dalla scheda Rendimento dashboard, scorri verso il basso fino alla tabella delle tracce, quindi seleziona la scheda secondaria Richieste di rete.
Seleziona Pattern personalizzati dal menu a discesa in Richieste di rete. .
Passa il mouse sopra la riga del pattern URL personalizzato da rimuovere.
Fai clic sulla all'estrema destra del seleziona Rimuovi pattern personalizzato, quindi conferma la rimozione nella finestra di dialogo.
Quando rimuovi un pattern URL personalizzato, tieni presente quanto segue:
Tutte le richieste future vengono mappate alla corrispondenza successiva più specifica pattern URL personalizzato. Se Firebase non trova pattern URL personalizzati corrispondenti, utilizza la corrispondenza automatica dei pattern URL.
Le corrispondenze e i dati aggregati delle richieste precedenti non sono interessati rimuovendo un pattern URL personalizzato.
Puoi comunque accedere a un pattern URL personalizzato rimosso e ai suoi dati aggregati Dati 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 tutte le i dati aggregati nel pattern URL personalizzato rimosso scadono, Firebase il pattern URL personalizzato.
La scheda secondaria Richieste di rete (con l'opzione Pattern personalizzati selezionata) non elencare eventuali pattern URL personalizzati rimossi.
Passaggi successivi
- Configura gli avvisi per le richieste di rete che stanno peggiorando 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 impostata.
Personalizza il modo in cui viene calcolata la 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 positive rispetto alle risposte totali. Questa metrica consente di misurare la rete e il server errori.
In particolare, Firebase conteggia automaticamente le richieste di rete con una risposta. nell'intervallo da 100 a 399 risposte riuscite.
Puoi personalizzare il calcolo della percentuale di successo contando determinati codici di errore come "risposte positive" oltre ai codici di risposta che Firebase viene conteggiato automaticamente come riuscito.
Ad esempio, se la tua app ha un'API endpoint di ricerca, puoi conteggiare le risposte 404 come "riuscite" perché sono previste per un endpoint di ricerca. Supponiamo che ci siano 100 campioni per questo endpoint di ricerca ogni ora e 60 sono 200 risposte e 40 sono 404 risposte. Prima di configurare la percentuale di successo, questa sarà pari al 60%. Dopo aver configurato l'esito il calcolo della percentuale di successo per conteggiare 404 risposte come riuscite, la percentuale 100%.
Configura il calcolo della percentuale di successo
Per configurare il calcolo della percentuale di successo per un pattern URL di rete, devi
dispongono dell'autorizzazione firebaseperformance.config.update. I seguenti ruoli includono questa autorizzazione richiesta per impostazione predefinita: Amministratore Firebase Performance, Amministratore Firebase Quality, Amministratore Firebase e Proprietario o Editor del progetto.
- Vai alla scheda Performance Monitoring Dashboard nella console Firebase, quindi seleziona l'app per la quale vuoi configurare un calcolo del tasso di successo.
- Scorri verso il basso fino alla tabella delle tracce nella parte inferiore dello schermo e seleziona l'icona Scheda Richieste di rete.
- Trova il pattern URL per il quale vuoi configurare la percentuale di successo calcolo.
- Apri il menu extra all'estrema destra della riga. () e seleziona Configurazione riuscita standard.
- Segui le istruzioni sullo schermo per selezionare i codici di risposta che vuoi vengono conteggiati come codici di risposta riusciti.