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 tagihan tak terduga 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 nilai minimum yang ditetapkan untuk anggaran Anda, Cloud Billing akan mengirimkan notifikasi email.
Perhatikan hal berikut:
Pemberitahuan anggaran tidak menjeda layanan. Fitur ini dimaksudkan untuk membantu Anda memantau biaya dan memberi tahu Anda sehingga Anda dapat mengambil tindakan, jika diperlukan. Misalnya, Anda dapat mempertimbangkan penggunaan pemberitahuan anggaran untuk menonaktifkan penagihan di project.
Saat mengupgrade ke paket harga Blaze di konsol Firebase, Anda akan otomatis diminta untuk menyiapkan anggaran khusus pemberitahuan. Anda juga dapat menyiapkan anggaran khusus pemberitahuan secara manual di Google Cloud console.
Anggaran batas pembelanjaan (halaman ini)
Jika pembelanjaan mencapai batas yang ditetapkan untuk anggaran Anda untuk layanan tertentu, maka Cloud Billing akan mengirimkan notifikasi email.
Jika pembelanjaan mencapai 100% dari anggaran Anda untuk layanan tersebut, Cloud Billing akan 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 konsol Firebase (seperti yang dijelaskan di halaman ini) atau di konsol Google Cloud.
- Sebelum menyiapkan anggaran batas pembelanjaan, tinjau informasi penting tentang anggaran batas pembelanjaan di halaman ini.
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 dokumentasi Google Cloud.
Layanan yang memenuhi syarat
Anggaran batas pembelanjaan dapat disiapkan untuk layanan Firebase berikut:
- Firebase AI Logic: Menetapkan batas akses ke Gemini Developer API atau Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: Menetapkan batas pada layanan Cloud Run yang mendasarinya.
- Cloud Functions for Firebase: Menetapkan batas pada layanan Cloud Run Functions yang mendasarinya.
- Firebase Extensions: Menetapkan 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% dari 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 dibatalkan.
- 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
Konfigurasi anggaran batas pembelanjaan.
Konfigurasi anggaran batas pembelanjaan agar Cloud Billing dapat mulai memantau pembelanjaan project Anda secara aktif untuk layanan tertentu.Pahami peringatan dan penegakan batas pembelanjaan.
Jika pembelanjaan project Anda mencapai nilai minimum 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.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 memberi Anda izin yang diperlukan:
Opsi 1: Peran Billing Account Administrator di akun Cloud Billing yang ditautkan ke project
Opsi 2: Peran Project Owner di project tempat Anda ingin mengonfigurasi anggaran batas pembelanjaan
Opsi 3: Kombinasi peran IAM tingkat project dan akun Cloud Billing berikut:
Peran Billing Account Costs Manager di akun Cloud Billing yang ditautkan ke project
dan
Peran Project Editor di project tempat Anda ingin mengonfigurasi anggaran batas pembelanjaan
Mengonfigurasi anggaran batas pembelanjaan
Agar Cloud Billing dapat secara aktif mulai memantau pembelanjaan Anda untuk suatu layanan, Anda perlu mengonfigurasi anggaran batas pembelanjaan untuk layanan tersebut. Jika project Anda mencapai batas pembelanjaan tertentu untuk layanan tersebut, Cloud Billing akan mengirim email pemberitahuan dan menerapkan batas pembelanjaan.
Berikut cara mengonfigurasi anggaran batas pembelanjaan menggunakan konsol Firebase:
Akses project Anda di Firebase console, lalu buka
Settings > Usage and billing > Details & settings page.Buka kartu Batas pembelanjaan tingkat layanan.
Temukan layanan yang ingin Anda batasi, tetapkan jumlah anggaran bulanan, lalu klik Konfigurasi.
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 konsol Google Cloud.
Email peringatan dan penerapan batas pembelanjaan
Setelah Anda mengonfigurasi anggaran batas pembelanjaan, Cloud Billing akan secara aktif memantau pembelanjaan project Anda untuk layanan tersebut. Sistem akan mengirim 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 mengirim email pemberitahuan peringatan kepada semua administrator penagihan, pemilik project, dan "kontak penting" yang berlaku.
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 membatalkan penerapan batas pembelanjaan.
Cloud Billing mengirim email pemberitahuan lain. 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).
Mencabut 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 membatalkan batas pembelanjaan yang diterapkan.
Berikut cara mencabut batas pembelanjaan yang diterapkan menggunakan konsol Firebase:
Akses project Anda di Firebase console, lalu buka
Settings > Usage and billing > Details & settings page.Buka kartu Batas pembelanjaan tingkat layanan.
Temukan layanan dengan batas pembelanjaan yang diterapkan, lalu klik Naikkan.
Perhatikan bahwa Anda juga dapat membatalkan batas pembelanjaan yang diterapkan menggunakan konsol Google Cloud.
Batasan anggaran batas pembelanjaan
Berikut adalah batasan penting yang perlu dipahami tentang anggaran batas pembelanjaan:
Anggaran batas pembelanjaan bukan "batas ketat". Karena latensi dalam pelaporan penggunaan, penegakan batas pembelanjaan tidak terjadi secara instan dan dapat tertunda selama beberapa menit. Kelebihan biaya apa pun yang terjadi selama penundaan ini akan ditagih seperti biasa. Pertimbangkan untuk menetapkan anggaran sedikit di bawah batas mutlak Anda.
Project dan layanan yang tercakup. 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 anggaran batas pembelanjaan tunggal yang akan mencakup beberapa project atau beberapa layanan.
Saat Anda menetapkan anggaran batas pembelanjaan untuk layanan, anggaran tersebut akan berlaku untuk semua cara Anda berinteraksi dengan layanan dalam 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. (bukan 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 mencabut batas pembelanjaan yang diterapkan, layanan akan tetap dijeda hanya untuk bulan ini.
Secara default, pada awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis dihentikan 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 mencabut batas pembelanjaan yang diterapkan.
Secara default, jika Anda tidak menaikkan batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk bulan ini, tetapi akan otomatis dilanjutkan di 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 mencabut batas pembelanjaan yang diterapkan.
Tidak termasuk penghematan dan kredit. Penghitungan biaya untuk anggaran batas pembelanjaan didasarkan pada biaya kotor dan tidak mencakup penghematan dan kredit.
Jika Anda memiliki konfigurasi penagihan yang lebih canggih, Anda dapat menemukan detail selengkapnya tentang batasan anggaran batas pembelanjaan dalam dokumentasi Google Cloud.