Comprendere il report sulla fatturazione

Questa pagina fornisce suggerimenti e risorse per aiutarti a comprendere il report sulla fatturazione di Firestore. Questa pagina riguarda le seguenti fonti di domande comuni sulla fatturazione:

  • Al di fuori dell'utilizzo delle app, le fonti dei costi includono le operazioni di importazione, le operazioni di esportazione e l'utilizzo della console.
  • All'interno della tua app, aggiornamenti in tempo reale, scritture non operative e compensazioni delle query possono aumentare l'utilizzo più velocemente del previsto.
  • Quando utilizzi la dashboard sull'utilizzo nella console, prendi nota delle discrepanze tra la dashboard e il report sulla fatturazione.

Utilizzo di importazione ed esportazione

Quando scomponi il report sulla fatturazione, assicurati di controllare i costi relativi alle operazioni di importazione ed esportazione. Queste operazioni eseguono operazioni di lettura e scrittura che vengono conteggiate ai fini della fatturazione di Firestore. A seconda della frequenza con cui importi ed esporti i dati, queste operazioni possono costituire una fonte significativa di operazioni fatturate.

Tieni presente che la dashboard sull'utilizzo nella console non riflette le letture e le scritture dalle operazioni di importazione ed esportazione. Puoi visualizzare le operazioni di importazione/esportazione e i costi correlati nei seguenti modi:

Etichette di fatturazione

Le operazioni di esportazione e importazione applicano l'etichetta goog-firestoremanaged:exportimport alle operazioni di lettura e scrittura. Nella pagina dei report di fatturazione Cloud, puoi utilizzare questa etichetta per visualizzare i costi relativi alle operazioni di importazione ed esportazione:

Accedi all'etichetta goog-firestoremanaged dal menu dei filtri.

Elenca operazioni recenti

Puoi visualizzare le operazioni di importazione ed esportazione recenti utilizzando la console o gcloud.

Console Google Cloud

Puoi visualizzare un elenco delle operazioni di esportazione e importazione recenti nella pagina Importazione/esportazione di Firestore della console Google Cloud.

Vai alla pagina di importazione/esportazione

gcloud

Utilizza il comando operations list per vedere tutte le operazioni di esportazione e importazione in esecuzione e recentemente completate:

gcloud firestore operations list

Audit log per le operazioni di amministrazione

Firestore scrive gli audit log per le operazioni di esportazione, di importazione e di indicizzazione. Consulta Informazioni sull'audit logging di Firestore.

Utilizzo della console

Le operazioni di lettura eseguite dal visualizzatore dati di Firestore nella console Firebase e nella console Cloud vengono conteggiate ai fini dell'utilizzo fatturato di Firestore. Quando apri o aggiorni la pagina Firestore, la console carica i documenti per completare la pagina. Finché la pagina Firestore rimane aperta, la console utilizza query in tempo reale per aggiornare i documenti e le raccolte visibili.

Quando suddividi l'utilizzo, considera l'utilizzo della console come un'altra fonte delle operazioni di Firestore. Nel report sulla fatturazione, non è possibile distinguere il traffico della console da quello delle applicazioni.

Operazioni fatturate

Oltre alle informazioni sui prezzi, controlla se nell'app sono presenti le seguenti operazioni, che possono comportare un aumento della fatturazione più veloce del previsto:

  • Aggiornamenti in tempo reale

    Quando ascolto i risultati di una query, ti viene addebitata una lettura ogni volta che un documento nel set di risultati viene aggiunto o aggiornato. Ti viene addebitata una lettura anche quando un documento viene rimosso dal set di risultati perché è stato modificato. (Al contrario, quando un documento viene eliminato, non ti viene addebitata una lettura).

    Esamina l'ambito dei tuoi ascoltatori in tempo reale. L'ascolto dei risultati di una query molto ampia o di un'intera raccolta potrebbe comportare più operazioni di lettura del necessario.

  • Operazioni di scrittura ed eliminazione autonomo

    Una modalità autonoma è un'operazione che non comporta modifiche ai documenti. Ti verranno comunque addebitati costi per le scritture e le eliminazioni no-op.

    Per un'operazione di eliminazione ti vengono addebitati dei costi anche se il documento specificato non esiste.

    Per un'operazione di scrittura, ti vengono comunque addebitati dei costi se le operazioni non comportano alcuna modifica. Ad esempio, un'operazione che aggiorna un campo documento allo stesso valore del campo comporta dei costi.

  • Offset delle query

    Gli offset delle query ignorano un numero specificato di risultati delle query, ma quelli ignorati vengono comunque conteggiati ai fini della fatturazione. A causa di questo costo aggiuntivo, dovresti utilizzare i cursors invece degli offset.

Discrepanze nella dashboard di utilizzo

Le dashboard sull'utilizzo di Firestore nelle console Firebase e Cloud forniscono una stima dell'utilizzo. Possono aiutarti a identificare picchi di utilizzo. Tuttavia, la 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 sulla dashboard sull'utilizzo.

Le operazioni che causano discrepanze tra la 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 nella dashboard di utilizzo.
  • Operazioni di scrittura di sola 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. Le operazioni che non comportano una modifica al database, come un aggiornamento che non modifica i valori dei campi o una scrittura in un documento eliminato, potrebbero essere visualizzate nella dashboard di utilizzo come "UPDATE_NOOP" o "DELETE_NOOP". Anche se vengono visualizzate come "NOOP", contribuiscono comunque alle operazioni fatturate.
  • Scritture compresse. In caso di più scritture in rapida successione sullo stesso documento, la dashboard di utilizzo potrebbe comprimere più scritture insieme e conteggiarle come una sola. 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. Per le query senza risultati è previsto il costo di un'operazione di lettura. Questo utilizzo è fatturato, ma non viene visualizzato nella dashboard sull'utilizzo.
  • Operazioni di lettura dalle voci di indice lette. Questo utilizzo è fatturato, ma non appare 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.

Passaggi successivi

Per ulteriore assistenza relativa al report sulla fatturazione, contatta l'assistenza per la fatturazione Cloud.