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 nilai minimum 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, maka 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 Anda juga meninjau batasan anggaran batas pembelanjaan di halaman ini.
Anda juga dapat menemukan daftar FAQ tentang anggaran batas pembelanjaan dalam dokumentasi Google Cloud.
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: 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 dicabut secara eksplisit.
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.
Saat dalam status Ditingkatkan, layanan berjalan tanpa batas pembelanjaan selama sisa bulan, kecuali jika Anda mengonfigurasi ulang atau menaikkan batas. Pada awal bulan berikutnya, anggaran batas pembelanjaan asli akan otomatis diaktifkan kembali.
Jika Anda tidak mencabut batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk bulan ini saja. Kemudian, di awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis direset dan layanan akan dilanjutkan.
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, batalkan batas pembelanjaan yang diterapkan (atau tingkatkan anggarannya).
Jika Anda ingin melanjutkan penggunaan layanan yang dijeda pada bulan tersebut (baik tanpa batas atau dengan anggaran yang lebih tinggi), Anda harus secara eksplisit mencabut 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:
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 Editor Project di project tempat Anda ingin mengonfigurasi anggaran batas pembelanjaan
Mengonfigurasi anggaran batas pembelanjaan
Agar Cloud Billing dapat mulai memantau pembelanjaan Anda untuk suatu layanan secara aktif, 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 Anda, 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 pemberitahuan dan penegakan batas pembelanjaan
Setelah Anda mengonfigurasi anggaran batas pembelanjaan, Cloud Billing akan memantau pembelanjaan project Anda secara aktif untuk layanan tersebut. Fitur ini 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 relevan.
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 Peningkatan.
Perhatikan bahwa Anda juga dapat membatalkan batas pembelanjaan yang diterapkan menggunakan konsol Google Cloud.
Meningkatkan batas pembelanjaan setelah penegakan
Jika batas pembelanjaan Anda diterapkan dan Anda ingin melanjutkan layanan dengan anggaran yang lebih tinggi selama sisa bulan (misalnya, meningkatkan batas dari $10 menjadi $20), Anda tidak dapat mengedit jumlah anggaran saat batas berada dalam status Diterapkan. Anda harus menghapus batas terlebih dahulu sebelum menetapkan batas yang lebih tinggi.
Berikut cara melanjutkan layanan dan meningkatkan batas pembelanjaannya:
Mencabut batas pembelanjaan: Di konsol Firebase atau konsol Google Cloud, temukan layanan yang diterapkan, lalu klik Cabut.
Batas pembelanjaan akan memasuki status menunggu keputusan saat penegakan dihapus.
Tunggu hingga pengangkatan selesai: Tunggu beberapa menit dan muat ulang halaman hingga status batas pembelanjaan menampilkan Diangkat.
Layanan akan dilanjutkan. Bergantung pada layanan, proses ini dapat memerlukan waktu hingga satu jam.
Perbarui jumlah anggaran: Edit anggaran batas pembelanjaan dengan memasukkan jumlah anggaran bulanan baru yang lebih tinggi. Simpan perubahan Anda.
Pertimbangan penting saat menaikkan batas:
Terkait dengan total pembelanjaan bulan berjalan: Jumlah anggaran baru masih terkait dengan total pembelanjaan terakumulasi Anda untuk bulan berjalan, termasuk kelebihan biaya yang terjadi selama penundaan pelaporan sebelum batas diterapkan.
Tetapkan anggaran yang lebih tinggi dari pembelanjaan bulan ini: Pastikan anggaran baru Anda lebih tinggi dari yang telah Anda belanjakan bulan ini (termasuk kelebihan penggunaan). Jika tidak, batas akan dipicu dan menjeda layanan lagi segera.
Penghitungan anggaran yang tersisa: Anggaran yang tersisa untuk bulan ini adalah jumlah nilai minimum baru dikurangi total pembelanjaan Anda sejauh ini. Contoh:
Anda menetapkan batas pembelanjaan Rp100.000 di Cloud Functions for Firebase.
Pembelanjaan Anda mencapai $10 (ditambah kelebihan $1 selama penundaan pelaporan, sehingga totalnya $11). Batas diterapkan, sehingga fungsi Anda dijeda.
Anda mengonfirmasi bahwa traffic tersebut sah, sehingga Anda menghapus batas dan menunggu hingga status menampilkan Dihapus.
Anda memperbarui batas pembelanjaan menjadi Rp200.000. Saat Anda menyimpan perubahan ini, batas pembelanjaan akan direset kembali ke status Dikonfigurasi.
Fungsi Anda akan terus berjalan dengan batas baru sebesar $20, dengan sekitar $9 anggaran yang tersisa untuk bulan tersebut ($20 batas dikurangi $11 yang sudah terakumulasi).
Pada bulan berikutnya, anggaran batas pembelanjaan akan mempertahankan nilai minimum $20.
Batasan anggaran batas pembelanjaan
Berikut adalah batasan penting yang perlu dipahami tentang anggaran batas pembelanjaan:
Anggaran batas pembelanjaan bukanlah "batas ketat". Karena latensi dalam pelaporan penggunaan, penerapan batas pembelanjaan tidak instan dan dapat tertunda selama beberapa menit. Kelebihan biaya 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 otomatis.
Jika Anda tidak mencabut batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk hanya bulan ini. Pada awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis direset ke status Dikonfigurasi dengan anggaran awal, dan layanan akan dilanjutkan.
Jika Anda menaikkan batas pembelanjaan yang diterapkan selama bulan tersebut dan tidak mengubah anggaran, layanan akan berjalan tanpa batas pembelanjaan selama sisa bulan tersebut, dan batas pembelanjaan akan otomatis direset ke status Dikonfigurasi dengan anggaran awal, dan layanan akan dilanjutkan.
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.