Questa pagina descrive come monitorare l'utilizzo di Cloud Firestore e individuare potenziali problemi nella tua app.
Dashboard di utilizzo
Per visualizzarli, usa le dashboard sull'utilizzo nella console Google Cloud e nella console Firebase operazioni di lettura, scrittura ed eliminazione di documenti nel tempo.
Controllo degli accessi
Le dashboard di utilizzo richiedono l'autorizzazione Cloud IAM monitoring.timeSeries.list.
I ruoli di Proprietario, Editor e Visualizzatore del progetto concedono questa autorizzazione. Puoi anche concedere questa autorizzazione
tramite un ruolo Cloud Monitoring
o un ruolo personalizzato.
Dashboard di utilizzo del database
Per visualizzare le metriche di utilizzo per un database Cloud Firestore, apri il database Usage nella console Google Cloud.
Nella console Google Cloud, vai alla pagina Database.
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Utilizzo.
Fai clic sul link nel messaggio visualizzato sulla pagina per visualizzare l'utilizzo del database.
Dashboard per l'utilizzo dei database Cloud Firestore nella console Google Cloud."/>
Dashboard sull'utilizzo aggregato
Se il tuo progetto ha più database Cloud Firestore, puoi visualizzare e metriche di utilizzo aggregate nella console Google Cloud o nella console Firebase.
Console Google Cloud
Nella console Google Cloud, vai alla pagina Utilizzo del progetto.
Vai all'utilizzo del progetto Google Cloud
La dashboard sull'utilizzo del progetto mostra le operazioni sui documenti nel tempo come segue:
Dashboard per l'utilizzo del progetto Cloud Firestore nella console Google Cloud."/>
Console Firebase
Vai alla pagina sull'utilizzo di Cloud Firestore (console Firebase)
Dashboard dell'utilizzo di Cloud Firestore nella console Firebase."/>
Dashboard di utilizzo e report sulla fatturazione
Dashboard sull'utilizzo di Cloud Firestore nelle console Firebase e Cloud fornire una stima dell'utilizzo. Possono aiutarti a identificare picchi di utilizzo. Tuttavia, la dashboard non offre una visualizzazione esatta delle operazioni fatturate. Utilizzo fatturato è probabilmente più alto. In tutti i casi di discrepanza, il report di fatturazione ha la precedenza sulla dashboard sull'utilizzo.
Operazioni che causano discrepanze tra la dashboard di utilizzo e la fatturazione di utilizzo includono:
- Operazioni di importazione ed esportazione. Letture e scritture eseguite da queste operazioni non vengono mostrati nella dashboard dell'utilizzo.
- Operazioni di scrittura solo per la verifica senza intervento. Scrive che verificano solo l'esistenza o la non esistenza di un documento e contribuiscono alle operazioni di lettura fatturate, ma vengono visualizzate rispettivamente come "UPDATE_NOOP" e "DELETE_NOOP" nella dashboard di utilizzo della scrittura.
- Operazioni di scrittura autonome. Operazioni che non comportano una modifica al database. ad esempio un aggiornamento che non modifica i valori dei campi o una scrittura su il documento potrebbe essere visualizzato nella dashboard dell'utilizzo come "UPDATE_NOOP" o "DELETE_NOOP". Anche se vengono visualizzate come "NOOP", contribuiscono comunque alle operazioni fatturate.
Scritture compresse. Nel caso in cui siano presenti più scritture sullo stesso documento in successione, la dashboard sull'utilizzo potrebbe comprimere più scritture insieme contarli come uno solo. Quando viene utilizzata la fatturazione, ogni scrittura viene comunque conteggiata separatamente.
La dashboard sull'utilizzo comprime anche le scritture per le trasformazioni dei campi, come timestamp del server, incrementi numerici e operazioni di unione degli array. Per le trasformazioni di campi, la dashboard di utilizzo potrebbe conteggiare più operazioni come una singola operazione.
- Query che restituiscono zero risultati. Le query senza risultati sono incluse il costo di un'operazione di lettura. Questo utilizzo è fatturato, ma non appare nella dashboard sull'utilizzo.
- Operazioni di lettura da Voci dell'indice lette. Questo utilizzo è fatturato ma non vengono visualizzate nella dashboard sull'utilizzo. Ad esempio, per le query di aggregazione viene letta la fatturazione relativa alle voci di indice, ma questo utilizzo non viene visualizzato nella dashboard sull'utilizzo.
La dashboard di utilizzo per le eliminazioni non acquisisce le operazioni di scadenza automatiche eseguite dai criteri di durata (TTL). Fai riferimento alle metriche TTL in Cloud Monitoring.
Utilizzo delle regole di sicurezza
Inoltre, la console Firebase fornisce una valutazione delle regole di sicurezza dashboard, una vista utile e immediata delle chiamate delle regole. Puoi integrare questa dashboard con un'analisi dettagliata Cloud Monitoring
Dashboard di monitoraggio delle regole Cloud Firestore nella console Firebase."/>
Cloud Monitoring metriche
Cloud Monitoring raccolte metriche, eventi e metadati di Google Cloud prodotti. L'utilizzo nella console Cloud Firestore riporta gli stessi dati delle metriche. A configurare dashboard personalizzate e avvisi sull'utilizzo, usa Cloud Monitoring.
Cloud Monitoring include le seguenti metriche Cloud Firestore:
| Nome metrica | Descrizione |
|---|---|
| Operazioni di lettura documenti |
Il numero di letture dei documenti riuscite. Puoi suddividere questa metrica in base al tipo di lettura: LOOKUP o QUERY. Questa metrica non include le letture delle operazioni di esportazione gestita. |
| Operazioni di scrittura documenti |
Il numero di scritture di documenti riuscite. Puoi suddividere la metrica con il tipo di scrittura: CREATE o UPDATE. Questa metrica non include le scritture dall'importazione gestita operazioni aziendali. |
| Operazioni di eliminazione documenti | Il numero di eliminazioni di documenti riuscite. |
| Connessioni attive |
Il numero di connessioni attive al tuo database. Ogni SDK per dispositivi mobili e web attivo mantiene una singola connessione, che può essere condivisa tra più snapshot e ascoltatori. Le librerie client del server una connessione per listener di snapshot. |
| Listener snapshot |
Il numero di listener snapshot in tutte le connessioni attive. |
| Conteggio eliminazioni time-to-live |
Conteggio totale di documenti eliminati da Criteri di durata (TTL). |
| Scadenza della durata (TTL) per i ritardi di eliminazione |
Il tempo trascorso tra la scadenza di un documento in base a Criterio di durata (TTL) e quando è stato effettivamente eliminato. |
- Utilizzo degli aggiornamenti in tempo reale
Utilizza le metriche relative alle connessioni attive e ai listener di snapshot per misurare L'utilizzo degli aggiornamenti in tempo reale.
Supponiamo che un utente apra la tua app sul proprio smartphone. L'app si connette quindi Cloud Firestore e sottoscrive 10 query. In questo modo, le tue metriche vengono incrementate di 1 connessione attiva e 10 listener snapshot.
- Frequenza di campionamento
Le metriche Cloud Firestore vengono campionate ogni minuto, ma gli aggiornamenti potrebbero la visualizzazione nelle tue dashboard può richiedere fino a 4 minuti.
Metriche di latenza
Le metriche di latenza di backend sono disponibili tramite le metriche comuni di Google Cloud firestore.
Ad esempio, un grafico della latenza p50 è disponibile nella visualizzazione Esplora metriche della console Cloud.
Configura una dashboard Cloud Monitoring
Per configurare una dashboard con le metriche di Cloud Firestore, consulta Gestire la dashboard personalizzata e Aggiungere widget alla dashboard.
Passaggi successivi
- Scopri di più su Cloud Monitoring.
- Scopri le best practice per il monitoraggio del rendimento di Firestore.