Analizzare gli insight sull'utilizzo

Questa pagina descrive come utilizzare gli insight sull'utilizzo per analizzare l'utilizzo fatturabile per database specifici. Puoi suddividere questi dati in base a dimensioni come raccolte, gruppi di raccolte o spazi dei nomi (specifici per la modalità Datastore) in un periodo di tempo personalizzato. Le metriche degli insight sull'utilizzo visualizzate variano in base alla versione o alla modalità:

Versione Metriche
Standard
  • Letture
  • Scritture (incluse eliminazioni)
  • Eliminazioni TTL
  • Letture dei flussi di dati (Listen richieste)
  • Scritture in streaming (StreamWrite richieste, incluse eliminazioni)
Enterprise
  • Unità di lettura
  • Unità di scrittura (incluse eliminazioni)
  • Unità di eliminazione TTL o di eliminazione gestita
  • Unità Eventarc
  • Unità di lettura in streaming (polling Listen)
  • Unità di lettura in tempo reale (aggiornamenti in streaming Listen)
  • Unità di scrittura in streaming (StreamWrite richieste, incluse le eliminazioni)

Panoramica degli insight sull'utilizzo

Utilizza la dashboard degli insight sull'utilizzo per monitorare l'utilizzo di database specifici. Questa dashboard ti aiuta a:

  • Monitora l'utilizzo granulare: monitora le operazioni fatturabili suddivise per dimensioni come collection, collectionGroup o namespace.
  • Ottimizza i costi: identifica l'utilizzo con fatturazione elevata per determinare dove puoi ottimizzare le strutture di dati o le query e ridurre la fattura complessiva.
  • Monitora le tendenze storiche: monitora il modo in cui le statistiche sull'utilizzo fatturabile cambiano in periodi di tempo specifici.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per visualizzare la dashboard degli insight sull'utilizzo, chiedi all'amministratore di concederti il ruolo Datastore Viewer

Ruolo IAM (roles/datastore.viewer) sul progetto.

Questo ruolo predefinito contiene l'autorizzazione datastore.insights.get, necessaria per visualizzare la dashboard degli insight sull'utilizzo.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Dashboard degli insight sull'utilizzo

La dashboard Insight sull'utilizzo è organizzata in due sezioni principali:

  • Utilizzo totale:mostra le metriche aggregate (letture, scritture, letture di stream, scritture di stream ed eliminazioni TTL) per l'intero database.
  • Utilizzo di GroupBy: mostra le metriche suddivise per le prime 100 dimensioni e raggruppate per raccolta, gruppo di raccolte o spazio dei nomi.

Metriche Utilizzo totale e GroupBy

È importante notare che la somma delle metriche nella sezione GroupBy potrebbe non corrispondere alla metrica visualizzata nella sezione Utilizzo totale. Questa variazione è prevista a causa dei seguenti fattori:

  • Limiti di GroupBy (primi 100): la sezione GroupBy è limitata alla suddivisione dell'utilizzo solo per le prime 100 raccolte, gruppi di raccolte o spazi dei nomi. L'utilizzo generato da dimensioni meno attive contribuisce al valore Utilizzo totale, ma non è elencato singolarmente nelle metriche di utilizzo GroupBy.
  • Campionamento per operazioni ampie: per le richieste che interessano un numero elevato di raccolte (ad esempio, join tra più raccolte, ListCollectionIds, ListDocuments, query senza tipo), gli insight sull'utilizzo possono campionare le raccolte, dando la priorità a quelle con l'utilizzo più elevato. Di conseguenza, non tutte le raccolte interessate sono incluse nelle metriche di utilizzo di GroupBy.
  • Nomi riservati:Cloud Firestore riserva i nomi con prefisso con doppio trattino basso (__*__) per i metadati interni. L'utilizzo relativo a questi nomi riservati contribuisce all'utilizzo totale, ma non è incluso nelle metriche di utilizzo di GroupBy.

    Dimensioni GroupBy

    La sezione GroupBy organizza le metriche di utilizzo in base alle dimensioni determinate dalle API abilitate:

    • Raccolta: disponibile quando l'API Cloud Firestore è abilitata.
    • Gruppo di raccolte: generalmente disponibile in tutte le configurazioni API.

    Dati degli insight sull'utilizzo

    Gli insight sull'utilizzo nella console Google Cloud mostrano i dati provenienti dai seguenti metodi API:

    • queryTopAggregatedInsightsData
    • queryTopTimeseriesInsightsData
    Nome campo Dettagli
    Nome raccolta

    Nome gruppo di raccolte
    Il valore corrispondente alla dimensione di utilizzo per cui vengono aggregati i dati di utilizzo. Potrebbe essere il nome di una raccolta o di un gruppo di raccolte
    Operazioni di lettura totali Numero totale di operazioni di lettura non in streaming. Applicabile solo alla versione Standard.
    Operazioni di scrittura totali Numero totale di operazioni di scrittura non in streaming. Sono incluse le operazioni di eliminazione. Applicabile solo alla versione Standard.
    Operazioni di lettura totali dello stream Numero totale di operazioni di lettura utilizzate per lo streaming delle richieste Listen (tra cui polling delle query iniziali, notifiche di modifica dei documenti in tempo reale, risultati ignorati, letture degli indici e addebiti minimi per la lettura). Applicabile solo alla versione Standard.
    Operazioni di scrittura totali dello stream Numero totale di operazioni di scrittura utilizzate per le richieste StreamWrite. Sono incluse le operazioni di eliminazione. Applicabile solo alla versione Standard.
    Operazioni di eliminazione TTL totali Numero totale di operazioni di eliminazione TTL. Applicabile solo alla versione Standard.
    Unità di lettura totali Numero totale di unità di lettura suddivise in tranche (tranche da 4 KiB) per le letture non in streaming. Applicabile solo alla versione Enterprise.
    Unità di scrittura totali Numero totale di unità di scrittura suddivise in tranche (tranche da 1 KiB) per le scritture non in modalità flusso di dati. Include le unità di eliminazione. Applicabile solo alla versione Enterprise.
    Operazioni di eliminazione TTL o eliminazione gestita totali Numero totale di unità di eliminazione TTL o di eliminazione gestita. Applicabile solo alla versione Enterprise.
    Unità Eventarc totali Numero totale di unità Eventarc. Applicabile solo alla versione Enterprise.
    Unità di lettura totali dello stream Numero totale di unità di lettura suddivise in tranche (tranche da 4 KiB) utilizzate per le operazioni di polling nelle richieste Listen in modalità flusso. Applicabile solo alla versione Enterprise.
    Unità di lettura in tempo reale totali Numero totale di unità di lettura in tempo reale (tranche da 1 KiB) utilizzate per gli aggiornamenti in streaming nelle richieste Listen. Applicabile solo alla versione Enterprise.
    Unità di scrittura stream totali Numero totale di unità di scrittura suddivise in tranche (tranche da 1 KiB) utilizzate per le richieste StreamWrite. Include le unità di eliminazione. Applicabile solo alla versione Enterprise.
    Byte totali letti Numero totale di byte scansionati.
    Numero totale di documenti scansionati Numero totale di documenti scansionati.
    Numero totale di voci di indice scansionate Numero totale di voci di indice scansionate.
    Numero totale di documenti scritti Numero totale di documenti scritti.
    Numero totale di voci di indice scritte Numero totale di voci di indice scritte.
    Somma totale delle dimensioni dei documenti scritti Dimensioni totali di scrittura dei documenti in byte.

    Limitazioni

    • Gli insight sull'utilizzo per le operazioni di amministrazione (che contribuiscono alle letture e alle scritture fatturabili) come importazione/esportazione, eliminazione in blocco, ripristino, clonazione e creazione di indici nella versione Enterprise non sono supportati.
    • La fatturazione per il traffico in uscita dalla rete e lo spazio di archiviazione non è supportata.

    Prezzi

    Non sono previsti costi aggiuntivi per gli insight sull'utilizzo.

    Visualizza insight sull'utilizzo

    Per visualizzare gli insight sull'utilizzo di un database Cloud Firestore, apri il riquadro Insight sull'utilizzo del database nella console Google Cloud.

    1. Nella console Google Cloud, vai alla pagina Database.

      Vai a Database

    2. Dall'elenco dei database, seleziona un database.

    3. Nel menu di navigazione, fai clic su Insight sull'utilizzo.

      Insight sull'utilizzo per un database in modalità nativa nella console Google Cloud

      Utilizza il menu a discesa Raggruppa per per visualizzare gli insight sull'utilizzo per una raccolta, un gruppo di raccolte o uno spazio dei nomi. Puoi visualizzare i dati degli insight sull'utilizzo fino agli ultimi 45 giorni.