Memahami laporan penagihan

Halaman ini memberikan tips dan referensi untuk membantu Anda memahami laporan penagihan Firestore. Halaman ini membahas sumber umum pertanyaan penagihan berikut:

  • Di luar penggunaan aplikasi, sumber biaya mencakup operasi impor, operasi ekspor, dan penggunaan konsol.
  • Dalam aplikasi Anda, update real-time, operasi tulis tanpa pengoperasian, dan offset kueri dapat membuat penggunaan Anda meningkat lebih cepat dari yang diharapkan.
  • Saat Anda menggunakan dasbor penggunaan di konsol, perhatikan perbedaan antara dasbor dan laporan penagihan.

Penggunaan Impor dan Ekspor

Saat menguraikan laporan penagihan, pastikan untuk meninjau biaya yang terkait dengan operasi impor dan ekspor. Operasi ini melakukan operasi baca dan tulis yang dihitung dalam penagihan Firestore Anda. Bergantung pada frekuensi impor dan ekspor data, operasi ini dapat menjadi sumber operasi yang ditagih secara signifikan.

Perhatikan bahwa dasbor penggunaan di konsol tidak mencerminkan operasi baca dan tulis dari operasi impor dan ekspor. Anda dapat melihat operasi impor/ekspor dan biaya terkait dengan cara berikut:

Label Penagihan

Operasi ekspor dan impor menerapkan label goog-firestoremanaged:exportimport ke operasi baca dan tulisnya. Di halaman laporan Penagihan Cloud, Anda dapat menggunakan label ini untuk melihat biaya yang terkait dengan operasi impor dan ekspor:

Akses label goog-firestoremanaged dari menu filter.

Mencantumkan operasi terbaru

Anda dapat melihat operasi impor dan ekspor terbaru menggunakan konsol atau gcloud.

Konsol

Anda dapat melihat daftar operasi ekspor dan impor terbaru di halaman Firestore Import/Export di Google Cloud konsol.

Buka halaman Import/Export

gcloud

Gunakan perintah operations list untuk melihat semua operasi ekspor dan impor yang berjalan dan baru selesai:

gcloud firestore operations list

Log Audit untuk operasi admin

Firestore menulis log audit untuk operasi ekspor, operasi impor, dan operasi pengindeksan. Lihat informasi log audit Firestore.

Penggunaan konsol

Operasi baca yang dilakukan oleh penampil data Firestore di Firebase Console dan konsol Cloud dihitung dalam penggunaan Firestore yang ditagih. Saat Anda membuka atau memuat ulang halaman Firestore, konsol akan memuat dokumen untuk mengisi halaman. Selama halaman Firestore tetap terbuka, konsol akan menggunakan kueri real-time untuk memperbarui dokumen dan koleksi yang terlihat.

Saat Anda menguraikan penggunaan, pertimbangkan penggunaan konsol sebagai sumber operasi Firestore lainnya. Dalam laporan penagihan, tidak ada cara untuk membedakan traffic konsol dari traffic aplikasi.

Operasi yang ditagih

Selain informasi harga, tinjau aplikasi Anda untuk operasi berikut yang dapat menyebabkan penagihan meningkat lebih cepat dari yang diharapkan:

  • Update real-time

    Saat Anda memproses hasil kueri, Anda akan dikenai biaya untuk operasi baca setiap kali dokumen dalam kumpulan hasil ditambahkan atau diperbarui. Anda juga akan dikenai biaya untuk operasi baca saat dokumen dihapus dari kumpulan hasil karena dokumen telah berubah. (Sebaliknya, saat dokumen dihapus, Anda tidak akan dikenai biaya untuk operasi baca.)

    Tinjau cakupan pemroses real-time Anda. Memproses hasil kueri yang sangat luas atau memproses seluruh koleksi dapat menghasilkan lebih banyak operasi baca daripada yang diperlukan.

  • Operasi tulis tanpa pengoperasian dan operasi hapus tanpa pengoperasian

    Operasi tanpa pengoperasian adalah operasi yang tidak menghasilkan perubahan pada dokumen apa pun. Anda tetap dikenai biaya untuk operasi tulis dan hapus tanpa pengoperasian.

    Untuk operasi hapus, Anda akan dikenai biaya meskipun dokumen yang diberikan tidak ada.

    Untuk operasi tulis, Anda tetap dikenai biaya jika operasi tidak menghasilkan perubahan. Misalnya, operasi yang memperbarui kolom dokumen ke nilai kolom yang sama akan dikenai biaya.

  • Offset kueri

    Offset kueri melewati jumlah hasil kueri yang ditentukan, tetapi hasil yang dilewati tetap dihitung dalam penagihan. Karena biaya tambahan ini, Anda harus menggunakan kursor dan bukan offset.

Perbedaan dasbor penggunaan

Dasbor penggunaan Firestore di Firebase console dan konsol Cloud memberikan perkiraan penggunaan. Langkah ini dapat membantu Anda mengidentifikasi lonjakan penggunaan. Namun, dasbor ini bukan tampilan persis dari operasi yang ditagih. Tagihan penggunaan kemungkinan lebih tinggi. Dalam semua kasus perbedaan, laporan penagihan lebih diutamakan daripada dasbor penggunaan.

Operasi yang menyebabkan perbedaan antara dasbor penggunaan dan penggunaan yang ditagih meliputi:

  • Operasi impor dan ekspor. Operasi baca dan tulis yang dilakukan oleh operasi impor dan ekspor tidak muncul di dasbor penggunaan.
  • Operasi tulis hanya verifikasi tanpa pengoperasian. Operasi tulis yang hanya memverifikasi keberadaan atau ketiadaan dokumen berkontribusi pada operasi baca yang ditagih, tetapi keduanya masing-masing ditampilkan sebagai UPDATE_NOOP dan DELETE_NOOP di dasbor penggunaan tulis.
  • Operasi tulis tanpa pengoperasian. Operasi yang tidak mengakibatkan perubahan pada database, misalnya update yang tidak mengubah nilai kolom atau operasi tulis pada dokumen yang dihapus dapat ditampilkan di dasbor penggunaan sebagai UPDATE_NOOP atau DELETE_NOOP. Meskipun ditampilkan sebagai NOOP, mereka tetap berkontribusi pada operasi yang ditagih.
  • Operasi tulis yang diciutkan. Untuk beberapa operasi tulis yang terjadi secara berurutan dalam waktu singkat pada dokumen yang sama, dasbor penggunaan mungkin menciutkan beberapa operasi tulis secara bersamaan dan menghitungnya sebagai satu operasi. Saat penagihan penggunaan, setiap operasi tulis tetap dihitung secara terpisah.

    Dasbor penggunaan juga menciutkan operasi tulis untuk transformasi kolom seperti operasi stempel waktu server, peningkatan numerik, dan penggabungan array. Untuk transformasi kolom, dasbor penggunaan dapat menghitung beberapa operasi sebagai satu operasi.

  • Kueri yang menampilkan hasil nol. Kueri dengan hasil nol akan dikenai biaya satu operasi baca. Penggunaan ini ditagih, tetapi tidak muncul di dasbor penggunaan.
  • Operasi baca dari entri indeks yang dibaca. Penggunaan ini ditagih, tetapi tidak muncul di dasbor penggunaan. Misalnya, kueri agregasi menagih untuk entri indeks yang dibaca, tetapi penggunaan ini tidak muncul di dasbor penggunaan.
  • Permintaan untuk mencantumkan ID koleksi. Dasbor penggunaan melaporkan satu operasi baca per ID koleksi yang berbeda dari penagihan.

Langkah berikutnya

Untuk mendapatkan bantuan lebih lanjut terkait laporan penagihan, hubungi Dukungan Penagihan Cloud.