Menyiapkan batas pembelanjaan untuk layanan Firebase


Halaman ini menjelaskan cara menyiapkan dan mengelola anggaran batas pembelanjaan saat project Firebase Anda menggunakan paket harga Blaze.

Anggaran batas pembelanjaan tersedia untuk layanan Firebase tertentu berikut: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, dan Firebase Extensions.

Langsung ke petunjuk untuk mengonfigurasi batas pembelanjaan

Memahami anggaran

Anda dapat mengontrol biaya dan menghindari hal yang tidak terduga pada tagihan dengan membuat anggaran untuk Google Cloud Billing. Anggaran adalah jumlah uang secara umum yang Anda rencanakan sebagai pengeluaran setiap bulan, dan dapat berupa anggaran khusus pemberitahuan atau anggaran batas pembelanjaan.

Anggaran khusus pemberitahuan

  • Jika pembelanjaan mencapai batas yang ditetapkan untuk anggaran Anda, maka Cloud Billing mengirimkan notifikasi email.

  • Perhatikan hal berikut:

Anggaran batas pembelanjaan (halaman ini)

  • Jika pembelanjaan mencapai batas yang ditetapkan untuk anggaran Anda untuk layanan tertentu, Penagihan Cloud akan Cloud Billing mengirimkan notifikasi email.

  • Jika pembelanjaan mencapai 100% anggaran Anda untuk layanan tersebut, maka Cloud Billing menjeda layanan tersebut selama sisa bulan.

  • Perhatikan hal berikut:

    • Anggaran batas pembelanjaan hanya tersedia untuk layanan Firebase berikut: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, dan Firebase Extensions.

    • Anda dapat menyiapkan anggaran batas pembelanjaan secara manual di Firebase konsol (seperti yang dijelaskan di halaman ini) atau di Google Cloud konsol.

Ringkasan anggaran batas pembelanjaan

Sebelum menyiapkan anggaran batas pembelanjaan, tinjau informasi di bagian ini, yang mencakup daftar layanan yang memenuhi syarat dan kemungkinan status batas pembelanjaan. Sebaiknya tinjau juga batasan anggaran batas pembelanjaan di halaman ini.

Anda juga dapat menemukan daftar FAQ tentang anggaran batas pembelanjaan di Google Cloud dokumentasi.

Layanan yang memenuhi syarat

Anggaran batas pembelanjaan dapat disiapkan untuk layanan Firebase berikut:

  • Firebase AI Logic: Tetapkan batas akses ke Gemini Developer API atau Agent Platform Gemini API (formerly Vertex AI).
  • Firebase App Hosting: Tetapkan batas pada layanan Cloud Run yang mendasarinya.
  • Cloud Functions for Firebase: Tetapkan batas pada layanan Cloud Run Functions yang mendasarinya.
  • Firebase Extensions: Tetapkan batas pada layanan Cloud Run Functions yang mendasarinya.

Kami sedang berupaya menambahkan layanan yang memenuhi syarat ke daftar ini untuk anggaran batas pembelanjaan. Jadi, periksa kembali daftar ini secara berkala.

Status batas pembelanjaan

Batas pembelanjaan dapat berada dalam salah satu status berikut:

  • Dikonfigurasi: Cloud Billing secara aktif memantau pembelanjaan project Anda untuk layanan tertentu berdasarkan anggaran batas pembelanjaan Anda.
  • Diterapkan: Pembelanjaan project Anda mencapai 100% anggaran bulanan yang ditetapkan untuk layanan tersebut, sehingga Cloud Billing menerapkan batas pembelanjaan. Penggunaan baru layanan tersebut selama sisa bulan akan dijeda kecuali jika batas pembelanjaan yang diterapkan secara eksplisit ditingkatkan.
  • Ditingkatkan: Cloud Billing telah menerapkan batas pembelanjaan (dan menjeda penggunaan baru layanan yang berlaku), tetapi batas pembelanjaan yang diterapkan secara eksplisit ditingkatkan untuk melanjutkan layanan.

Menyiapkan dan mengelola batas pembelanjaan

  1. Konfigurasi anggaran batas pembelanjaan.
    Konfigurasi anggaran batas pembelanjaan agar Cloud Billing dapat mulai memantau pembelanjaan project Anda secara aktif untuk layanan tertentu.

  2. Memahami pemberitahuan dan penerapan batas pembelanjaan.
    Jika pembelanjaan project Anda mencapai batas tertentu dari anggaran bulanan untuk layanan tersebut, Cloud Billing akan mengirimkan email pemberitahuan dan menerapkan batas pembelanjaan. Penerapan berarti penggunaan baru layanan tersebut akan dijeda selama sisa bulan tersebut.

  3. Secara opsional, tingkatkan batas pembelanjaan yang diterapkan.
    Jika ingin melanjutkan penggunaan layanan yang dijeda pada bulan tersebut, Anda harus secara eksplisit meningkatkan batas pembelanjaan yang diterapkan.

Izin yang diperlukan

Untuk menyiapkan dan mengelola anggaran batas pembelanjaan, Anda memerlukan akses tingkat admin ke project dan akun Cloud Billing yang ditautkan. Salah satu opsi berikut akan memberi Anda izin yang diperlukan:

Mengonfigurasi anggaran batas pembelanjaan

Agar Cloud Billing dapat mulai memantau pembelanjaan Anda untuk layanan secara aktif, Anda harus mengonfigurasi anggaran batas pembelanjaan untuk layanan tersebut. Jika project Anda mencapai batas pembelanjaan tertentu untuk layanan tersebut, Cloud Billingakan mengirimkan email pemberitahuan dan menerapkan batas pembelanjaan.

Berikut cara mengonfigurasi anggaran batas pembelanjaan menggunakan Firebase console:

  1. Akses project Anda di Firebase console, lalu buka halaman Setelan > Penggunaan dan penagihan > Detail & setelan.

  2. Buka kartu Service-level spend caps.

  3. Temukan layanan yang ingin Anda batasi, tetapkan jumlah anggaran bulanan, lalu klik Configure.

    • Anggaran batas pembelanjaan dicakup ke satu project dan satu layanan yang memenuhi syarat dalam project tersebut.

    • Rentang waktu untuk anggaran batas pembelanjaan adalah bulanan, dimulai pada hari pertama setiap bulan.

Perhatikan bahwa Anda juga dapat mengonfigurasi anggaran batas pembelanjaan menggunakan Google Cloud konsol.

Email pemberitahuan dan penerapan batas pembelanjaan

Setelah Anda mengonfigurasi anggaran batas pembelanjaan, Cloud Billing akan memantau pembelanjaan project Anda secara aktif untuk layanan tersebut. Penagihan Cloud akan mengirimkan email pemberitahuan dan menerapkan batas pembelanjaan berdasarkan batas pembelanjaan berikut untuk anggaran batas pembelanjaan layanan tersebut.

  • 50% dan 80% dari anggaran yang ditetapkan:

    • Cloud Billing mengirimkan email pemberitahuan peringatan kepada semua administrator penagihan, pemilik project, dan "kontak penting".
  • 100% dari anggaran yang ditetapkan:

    • Cloud Billing menerapkan batas pembelanjaan, yang berarti penggunaan baru untuk layanan yang berlaku akan dijeda selama sisa bulan tersebut kecuali jika Anda secara eksplisit meningkatkan batas pembelanjaan yang diterapkan.

    • Cloud Billing mengirimkan email pemberitahuan lainnya. Selain itu, konsol Firebase dan konsol Google Cloud menampilkan notifikasi banner tentang penerapan batas pembelanjaan dan layanan yang dijeda.

Dampak sisi klien dan penanganan error

Saat layanan dijeda karena batas pembelanjaan yang diterapkan, aplikasi sisi klien Anda akan mulai menampilkan error untuk layanan tersebut. Anda harus menangani pengecualian ini dengan baik dalam kode aplikasi (misalnya, menggunakan blok try-catch).

Meningkatkan batas pembelanjaan yang diterapkan

Jika batas pembelanjaan dipicu dan diterapkan, semua penggunaan baru untuk layanan yang berlaku akan dijeda selama sisa bulan tersebut kecuali jika Anda secara eksplisit meningkatkan batas pembelanjaan yang diterapkan.

Berikut cara meningkatkan batas pembelanjaan yang diterapkan menggunakan Firebase console:

  1. Akses project Anda di Firebase console, lalu buka halaman Setelan > Penggunaan dan penagihan > Detail & setelan.

  2. Buka kartu Service-level spend caps.

  3. Temukan layanan dengan batas pembelanjaan yang diterapkan, lalu klik Lift.

Perhatikan bahwa Anda juga dapat meningkatkan batas pembelanjaan yang diterapkan menggunakan Google Cloudkonsol.

Batasan anggaran batas pembelanjaan

Berikut batasan penting yang perlu dipahami tentang anggaran batas pembelanjaan:

  • Anggaran batas pembelanjaan bukan "batas ketat". Karena latensi dalam pelaporan penggunaan, penerapan batas pembelanjaan tidak instan dan dapat tertunda selama beberapa menit. Setiap biaya yang melebihi batas yang terjadi selama penundaan ini akan ditagih seperti biasa. Sebaiknya tetapkan anggaran sedikit di bawah batas absolut Anda.

  • Dicakup ke project dan layanan. Anggaran batas pembelanjaan dicakup ke satu project dan satu layanan yang memenuhi syarat dalam project tersebut.

    • Anda tidak dapat menetapkan anggaran batas pembelanjaan di seluruh tingkat akun Cloud Billing atau di tingkat Folder, Organisasi, atau Label.

    • Anda tidak dapat menetapkan satu anggaran batas pembelanjaan yang akan mencakup beberapa project atau beberapa layanan.

    • Jika Anda menetapkan anggaran batas pembelanjaan untuk layanan, anggaran tersebut akan berlaku untuk cara apa pun yang mungkin Anda gunakan untuk berinteraksi dengan layanan di project. Misalnya, jika Anda menetapkan anggaran di Agent Platform Gemini API (formerly Vertex AI), anggaran tersebut juga berlaku untuk penggunaan API tersebut di project melalui Firebase SQL Connect, ADK, Genkit, dll. (tidak hanya penggunaan melalui Firebase AI Logic).

  • Rentang waktu bulanan. Rentang waktu anggaran batas pembelanjaan adalah bulanan, dimulai pada hari pertama setiap bulan.

  • Layanan dilanjutkan setiap bulan secara default. Jika Anda tidak meningkatkan batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk bulan ini saja.

    • Secara default, pada awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis ditingkatkan dan layanan akan dilanjutkan.

    • Namun, Anda dapat menyesuaikan setelan anggaran batas pembelanjaan sehingga batas pembelanjaan tetap diterapkan (dan layanan tetap dijeda) tanpa batas waktu hingga Anda secara eksplisit meningkatkan batas pembelanjaan yang diterapkan.

    Secara default, jika Anda tidak meningkatkan batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk bulan ini, tetapi akan otomatis dilanjutkan pada awal bulan berikutnya. Namun, Anda dapat menyesuaikan setelan anggaran batas pembelanjaan sehingga batas pembelanjaan tetap diterapkan (dan layanan tetap dijeda) tanpa batas waktu hingga Anda secara eksplisit meningkatkan batas pembelanjaan yang diterapkan.

  • Tidak menyertakan penghematan dan kredit. Perhitungan biaya untuk anggaran batas pembelanjaan didasarkan pada biaya kotor dan tidak menyertakan penghematan dan kredit.

Jika memiliki penyiapan penagihan yang lebih canggih, Anda dapat menemukan detail selengkapnya tentang batasan anggaran batas pembelanjaan di Google Cloud dokumentasi.