Questa pagina descrive come monitorare l'utilizzo di Cloud Firestore e individuare potenziali problemi nella tua app.
Cruscotto di utilizzo
Utilizza i dashboard di utilizzo nella console Google Cloud Platform e nella console Firebase per visualizzare le letture, le scritture e le eliminazioni dei documenti nel tempo.
Controllo di accesso
I dashboard di utilizzo richiedono l'autorizzazione monitoring.timeSeries.list Cloud IAM. I ruoli Proprietario del progetto, Editor e Visualizzatore concedono questa autorizzazione. Puoi anche concedere questa autorizzazione tramite un ruolo Cloud Monitoring o un ruolo personalizzato .
Dashboard sull'utilizzo del database
Per visualizzare le metriche di utilizzo per un database Cloud Firestore, apri la pagina Utilizzo del database nella console GCP.
Nella console di Google Cloud Platform, vai alla pagina Database .
Selezionare il database richiesto dall'elenco dei database.
Nel menu di navigazione, fare clic su Utilizzo .
Fare clic sul collegamento nel messaggio visualizzato nella pagina per visualizzare l'utilizzo del database.
Dashboard di utilizzo aggregato
Se il tuo progetto ha più database Cloud Firestore, puoi visualizzare i parametri di utilizzo aggregati nella console GCP o nella console Firebase.
Console GCP
Nella console di Google Cloud Platform, vai alla pagina Utilizzo del progetto .
Vai a Utilizzo del progetto del progetto GCP
Il dashboard di utilizzo del progetto mostra le operazioni sui documenti nel tempo come segue:
Console Firebase
Vai alla pagina di utilizzo di Cloud Firestore (console Firebase)
Dashboard sull'utilizzo e report di fatturazione
I dashboard di utilizzo di Cloud Firestore nelle console Firebase e Cloud forniscono una stima dell'utilizzo. Possono aiutarti a identificare i picchi di utilizzo. Tuttavia, il dashboard non offre una visualizzazione esatta delle operazioni fatturate. L'utilizzo fatturato è probabilmente più elevato. In tutti i casi di discrepanza, il report di fatturazione ha la precedenza sul dashboard di utilizzo.
Le operazioni che causano discrepanze tra il dashboard di utilizzo e l'utilizzo fatturato includono:
- Operazioni di importazione ed esportazione. Le letture e le scritture eseguite da queste operazioni non vengono visualizzate nel dashboard di utilizzo.
- Nessuna scrittura di sola verifica operativa. Le scritture che verificano solo l'esistenza o la non esistenza di un documento contribuiscono alle operazioni di lettura fatturate, ma vengono visualizzate rispettivamente come "UPDATE_NOOP" e "DELETE_NOOP" nel dashboard di utilizzo della scrittura.
- No-op scrive. Le operazioni che non comportano una modifica al database, come un aggiornamento che non modifica i valori dei campi o una scrittura su un documento eliminato, possono essere visualizzate nel dashboard di utilizzo come "UPDATE_NOOP" o "DELETE_NOOP". Anche se vengono visualizzati come "NOOP", contribuiscono comunque alle operazioni fatturate.
Scritture crollate. Nei casi in cui sono presenti più scritture sullo stesso documento in rapida successione, il dashboard di utilizzo potrebbe comprimere più scritture insieme e contarle come una sola. Quando si fattura l'utilizzo, ogni scrittura viene comunque conteggiata separatamente.
Il dashboard di utilizzo comprime inoltre le scritture per le trasformazioni di campo come timestamp del server, incrementi numerici e operazioni di unione di array. Per le trasformazioni dei campi, il dashboard di utilizzo potrebbe conteggiare più operazioni come una singola operazione.
- Query che restituiscono zero risultati. Le query con zero risultati comportano il costo di un'operazione di lettura. Questo utilizzo viene fatturato ma non viene visualizzato nel dashboard di utilizzo.
- Operazioni di lettura associate a query di aggregazione come COUNT. Questo utilizzo viene fatturato ma non viene visualizzato nel dashboard di utilizzo.
Il dashboard di utilizzo per le eliminazioni non acquisisce le operazioni di scadenza automatica eseguite dai criteri TTL (Time-to-live). Fare riferimento alle metriche TTL di Cloud Monitoring .
Utilizzo delle regole di sicurezza
Inoltre, la console Firebase fornisce un dashboard di valutazione delle regole di sicurezza, una visualizzazione utile e immediata delle invocazioni delle regole. Puoi integrare questa dashboard con un'analisi dettagliata in Cloud Monitoring .
Metriche di monitoraggio del cloud
Cloud Monitoring raccoglie metriche, eventi e metadati dai prodotti Google Cloud. Il dashboard di utilizzo nella console Cloud Firestore riporta gli stessi dati di parametri. Per impostare dashboard personalizzati e avvisi sull'utilizzo, utilizza Cloud Monitoring.
Cloud Monitoring include i seguenti parametri Cloud Firestore:
| Nome metrico | Descrizione |
|---|---|
| Il documento legge | Il numero di letture di documenti riuscite. Puoi suddividere questa metrica in base al tipo di lettura: LOOKUP o QUERY. Questa metrica non include le letture dalle operazioni di esportazione gestite. |
| Il documento scrive | Il numero di scritture di documenti riuscite. Puoi suddividere la metrica in base al tipo di scrittura: CREATE o UPDATE. Questa metrica non include le scritture da operazioni di importazione gestite. |
| Eliminazioni di documenti | Il numero di eliminazioni di documenti riuscite. |
| Connessioni attive | Il numero di connessioni attive al tuo database. Ogni SDK mobile e Web attivo mantiene una singola connessione, che può essere condivisa tra più ascoltatori di snapshot. Le librerie client del server creano una connessione per ogni listener di snapshot. |
| Ascoltatori di istantanee | Il numero di listener di snapshot su tutte le connessioni attive. |
| Conteggio delle eliminazioni di durata | Conteggio totale dei documenti eliminati dai criteri Time-to-live (TTL) . |
| Scadenza temporale per ritardi di eliminazione | Tempo trascorso tra il momento in cui un documento è scaduto in base a un criterio TTL (Time-to-live) e il momento in cui è stato effettivamente eliminato. |
- Utilizzo degli aggiornamenti in tempo reale
Utilizza le connessioni attive e le metriche degli ascoltatori di snapshot per misurare l'utilizzo degli aggiornamenti in tempo reale .
Supponiamo che un utente apra la tua app sul proprio telefono. L'app si connette quindi a Cloud Firestore e si iscrive a 10 query. Ciò aumenta le tue metriche di 1 connessione attiva e 10 ascoltatori di istantanee.
- Frequenza di campionamento
I parametri Cloud Firestore vengono campionati ogni minuto, ma gli aggiornamenti potrebbero richiedere fino a 4 minuti per essere visualizzati nei dashboard.
Metriche di latenza
I parametri di latenza del backend sono disponibili tramite i comuni parametri di runtime del servizio Google Cloud.
Ad esempio, è possibile trovare un grafico della latenza p50 nella visualizzazione Esplora parametri di Cloud Console.
Configura una dashboard di Cloud Monitoring
Per configurare una dashboard con i parametri Cloud Firestore, consulta Gestire la dashboard personalizzata e Aggiungere widget della dashboard .
Qual è il prossimo
- Ulteriori informazioni sul monitoraggio del cloud.
- Scopri le migliori pratiche per monitorare le prestazioni di Firestore .