Menyiapkan batas pembelanjaan untuk layanan Firebase

Pratinjau: Anggaran batas pembelanjaan tersedia dalam Pratinjau, yang berarti anggaran tersebut tidak tunduk pada SLA atau kebijakan penghentian layanan apa pun dan dapat berubah sehingga tidak kompatibel dengan versi sebelumnya.

Halaman ini menjelaskan cara menyiapkan dan mengelola anggaran batas pengeluaran 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.

Penting: Batas pembelanjaan bukan "batas mutlak". Karena latensi dalam pelaporan penggunaan, penerapan batas pengeluaran tidak instan dan dapat tertunda selama beberapa menit. Setiap kelebihan biaya yang timbul selama penundaan ini akan ditagih seperti biasa.
Oleh karena itu, Anda harus menetapkan anggaran sedikit di bawah batas absolut, serta menganggap batas pembelanjaan sebagai salah satu alat yang dapat membantu Anda mengelola biaya dan mengurangi dampak tagihan besar yang tidak terduga. Pelajari lebih lanjut opsi logika dan pemberitahuan tambahan.

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 pengeluaran mencapai nilai minimum yang ditetapkan untuk anggaran Anda, Cloud Billing akan mengirimkan notifikasi email.

• Perhatikan hal berikut:

  • Pemberitahuan anggaran tidak menjeda layanan. Anggaran dan pemberitahuan anggaran dimaksudkan untuk membantu Anda memantau biaya dan memberi tahu Anda sehingga Anda dapat mengambil tindakan, jika diperlukan. Misalnya, Anda dapat mempertimbangkan penggunaan notifikasi anggaran untuk menonaktifkan penagihan pada project.

  • Saat mengupgrade ke paket harga Blaze di Firebase console, Anda akan otomatis diminta untuk menyiapkan anggaran khusus pemberitahuan. Anda juga dapat menyiapkan anggaran khusus pemberitahuan secara manual di konsol Google Cloud.

Anggaran batas pembelanjaan (halaman ini)

• Jika pengeluaran mencapai nilai minimum yang ditetapkan untuk anggaran Anda untuk layanan tertentu, 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 Firebase console (seperti yang dijelaskan di halaman ini) atau di Google Cloud console.

  • Sebelum menyiapkan anggaran batas pembelanjaan, tinjau informasi penting tentang anggaran batas pembelanjaan di bagian bawah halaman ini.

Semua project Firebase sebenarnya adalah project Google Cloud, sehingga penagihan berlaku untuk Firebase dan Google Cloud. Anda dapat melihat project yang sama di Firebase console dan Google Cloud console.

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 bagian bawah 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: 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 untuk anggaran batas pembelanjaan ke daftar ini, jadi periksa kembali daftar ini secara berkala.

Catatan: Jika Anda menetapkan anggaran batas pembelanjaan untuk salah satu layanan pokok di atas, anggaran tersebut akan berlaku di tingkat project dan untuk semua cara Anda berinteraksi dengan layanan dalam project. Misalnya, jika Anda menetapkan anggaran pada Agent Platform Gemini API (formerly Vertex AI), anggaran tersebut juga berlaku untuk penggunaan API tersebut dalam project melalui Firebase SQL Connect, ADK, Genkit, dll. (bukan hanya penggunaan melalui Firebase AI Logic).

Status batas pembelanjaan

Batas pembelanjaan dapat berada dalam salah satu status berikut:

• Dikonfigurasi: Cloud Billing secara aktif memantau pengeluaran project Anda untuk layanan tertentu berdasarkan anggaran batas pengeluaran Anda.

• Diterapkan: Pengeluaran project Anda mencapai 100% dari anggaran bulanan yang ditetapkan untuk layanan tersebut, sehingga Cloud Billing menerapkan batas pembelanjaan. Setiap penggunaan baru layanan selama sisa bulan tersebut 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 Dicabut, layanan akan berjalan tanpa batas pembelanjaan selama sisa bulan tersebut, kecuali jika Anda mengonfigurasi ulang atau meningkatkan batas. Pada awal bulan berikutnya, anggaran batas pembelanjaan awal akan otomatis diaktifkan kembali.

Catatan: Mengubah konfigurasi batas pembelanjaan (bahkan mengganti nama anggaran di konsol Google Cloud) akan mengembalikan batas pembelanjaan ke status Configured. Jika pembelanjaan bulanan Anda sudah memenuhi atau melebihi nilai minimum anggaran, batas akan langsung dipicu dan diterapkan.

Jika Anda tidak mencabut batas pembelanjaan yang diterapkan, layanan akan tetap dijeda untuk bulan berjalan saja. Kemudian, pada awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis direset dan layanan akan dilanjutkan.

Menyiapkan dan mengelola batas pembelanjaan

Catatan: Sebelum menyiapkan anggaran batas pembelanjaan, tinjau ringkasan anggaran batas pembelanjaan di bagian awal halaman ini.

1. Konfigurasikan anggaran batas pembelanjaan.
   Konfigurasikan 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 pengeluaran 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.

3. Secara opsional, hapus batas pembelanjaan yang diterapkan (atau tingkatkan anggarannya).
   Jika ingin melanjutkan penggunaan untuk layanan yang dijeda pada bulan tersebut (tanpa batas atau dengan anggaran yang lebih tinggi), Anda harus secara eksplisit mencabut batas pengeluaran yang diterapkan.

Izin yang diperlukan

Untuk menyiapkan dan mengelola anggaran batas pengeluaran, 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 pada project tempat Anda ingin mengonfigurasi anggaran batas pembelanjaan

• Opsi 3: Kombinasi akun Cloud Billing dan peran IAM level project berikut:

  • Peran Billing Account Costs Manager di akun Cloud Billing yang ditautkan ke project

    dan

  • Peran Project Editor pada project tempat Anda ingin mengonfigurasi anggaran batas pembelanjaan

Mengonfigurasi anggaran batas pembelanjaan

Agar Cloud Billing dapat mulai memantau pengeluaran Anda untuk suatu layanan secara aktif, Anda harus mengonfigurasi anggaran batas pengeluaran untuk layanan tersebut. Jika project Anda mencapai batas pengeluaran tertentu untuk layanan tersebut, Cloud Billing akan mengirim 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 Settings > Usage and billing > Details & settings.

2. Buka kartu Batas pembelanjaan tingkat layanan.

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

   • Anggaran batas pembelanjaan dicakupkan 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.

Perhatian: Anggaran batas pembelanjaan bukan "batas ketat". Karena latensi dalam pelaporan penggunaan, penerapan batas pembelanjaan tidak instan. Setiap kelebihan biaya yang timbul selama penundaan ini akan ditagih seperti biasa. Pertimbangkan untuk menetapkan anggaran sedikit di bawah batas absolut Anda.

Perlu diperhatikan bahwa Anda juga dapat mengonfigurasi anggaran batas pengeluaran menggunakan Google Cloud console.

Email pemberitahuan dan penerapan batas pembelanjaan

Setelah Anda mengonfigurasi anggaran batas pembelanjaan, Cloud Billing akan secara aktif memantau pengeluaran project Anda untuk layanan tersebut. Tindakan ini akan mengirim email pemberitahuan dan menerapkan batas pembelanjaan berdasarkan nilai minimum pembelanjaan berikut untuk anggaran batas pembelanjaan layanan tersebut.

• 50% dan 80% dari anggaran yang ditetapkan:

  • Cloud Billing mengirim email pemberitahuan peringatan ke semua administrator penagihan, Project Owner, dan "kontak penting" yang berlaku.

• 100% dari anggaran yang ditetapkan:

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

  • Cloud Billing mengirim email notifikasi 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 mencabut batas pembelanjaan yang diterapkan.

Berikut cara mencabut batas pembelanjaan yang diterapkan menggunakan Firebase console:

1. Akses project Anda di Firebase console, lalu buka halaman Settings > Usage and billing > Details & settings.

2. Buka kartu Batas pembelanjaan tingkat layanan.

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

Perhatikan hal berikut untuk mencabut batas pembelanjaan:

• Kemungkinan penundaan untuk melanjutkan layanan: Beberapa layanan mungkin memerlukan waktu hingga satu jam untuk dilanjutkan sepenuhnya setelah Anda mencabut batas pembelanjaan yang diterapkan.
• Tidak ada batas untuk sisa bulan: Jika Anda mencabut batas pembelanjaan yang diterapkan dan tidak melakukan perubahan lain, layanan akan berjalan tanpa batas pembelanjaan selama sisa bulan tersebut. Pada awal bulan berikutnya, batas pembelanjaan akan otomatis direset ke status Dikonfigurasi dengan anggaran awal, dan layanan akan dilanjutkan.
• Jika Anda tidak mencabut batas pembelanjaan yang diterapkan: Layanan tetap dijeda hanya untuk bulan berjalan. Pada awal bulan berikutnya, batas pembelanjaan akan otomatis direset ke status Dikonfigurasi dengan anggaran awal, dan layanan akan dilanjutkan.

Perlu diperhatikan bahwa Anda juga dapat mencabut batas pembelanjaan yang diterapkan menggunakan Google Cloud console.

Meningkatkan batas pembelanjaan setelah penegakan kebijakan

Jika batas pembelanjaan Anda diterapkan dan Anda ingin melanjutkan layanan dengan anggaran yang lebih tinggi untuk sisa bulan tersebut (misalnya, meningkatkan batas dari $10 menjadi $20), Anda tidak dapat mengedit jumlah anggaran saat batas berada dalam status Diterapkan. Anda harus mencabut batas terlebih dahulu sebelum menetapkan batas yang lebih tinggi.

Berikut cara melanjutkan layanan dan meningkatkan batas pembelanjaannya:

1. Mencabut batas pengeluaran: Di konsol Firebase atau konsol Google Cloud, temukan layanan yang diberlakukan, lalu klik Cabut.

   Batas pembelanjaan akan memasuki status tertunda saat penerapan dihapus.

2. Tunggu hingga pencabutan selesai: Tunggu beberapa menit dan muat ulang halaman hingga status batas pembelanjaan menampilkan Dicabut.

   Layanan akan dilanjutkan. Bergantung pada layanannya, proses ini dapat memerlukan waktu hingga satu jam.

3. 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 yang terakumulasi untuk bulan berjalan, termasuk kelebihan biaya yang timbul selama penundaan pelaporan sebelum batas diberlakukan.

• Tetapkan anggaran yang lebih tinggi dari pembelanjaan bulan berjalan: Pastikan anggaran baru Anda lebih tinggi dari jumlah yang telah Anda belanjakan bulan ini (termasuk kelebihan biaya). Jika tidak, batas akan memicu dan menjeda layanan lagi segera.

• Penghitungan sisa anggaran: Sisa anggaran Anda untuk bulan tersebut adalah jumlah nilai minimum baru dikurangi total pembelanjaan Anda sejauh ini. Contoh:

  1. Anda menetapkan batas pembelanjaan $10 pada Cloud Functions for Firebase.

  2. Pembelanjaan Anda mencapai $10 (ditambah kelebihan $1 selama penundaan pelaporan, sehingga totalnya menjadi $11). Batas diterapkan, sehingga menjeda fungsi Anda.

  3. Anda mengonfirmasi bahwa traffic tersebut sah, jadi Anda mencabut batas dan menunggu statusnya menampilkan Lifted.

  4. Anda memperbarui batas pembelanjaan menjadi $20. Saat Anda menyimpan perubahan ini, batas pembelanjaan akan direset kembali ke status Dikonfigurasi.

  5. Fungsi Anda terus berjalan di bawah batas baru sebesar $20, dengan sisa anggaran sekitar $9 untuk bulan tersebut (batas $20 dikurangi $11 yang telah terakumulasi).

  6. 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 bukan "batas ketat". Karena adanya latensi dalam pelaporan penggunaan, penerapan batas pembelanjaan tidak instan dan dapat tertunda selama beberapa menit. Setiap kelebihan biaya yang timbul selama penundaan ini akan ditagih seperti biasa. Sebaiknya tetapkan anggaran sedikit di bawah batas absolut Anda.

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

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

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

  • Saat Anda menetapkan anggaran batas pengeluaran untuk suatu layanan, anggaran tersebut berlaku untuk semua cara Anda berinteraksi dengan layanan dalam project. Misalnya, jika Anda menetapkan anggaran pada Agent Platform Gemini API (formerly Vertex AI), anggaran tersebut juga berlaku untuk penggunaan API tersebut dalam 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 akan dilanjutkan setiap bulan secara otomatis.

  • Jika Anda tidak mencabut batas pembelanjaan yang diterapkan, layanan akan tetap dijeda hanya untuk bulan berjalan. Pada awal bulan berikutnya, batas pembelanjaan yang diterapkan akan otomatis direset ke status Configured 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 memiliki konfigurasi penagihan yang lebih rumit, Anda dapat menemukan detail selengkapnya tentang batasan anggaran batas pembelanjaan di dokumentasi Google Cloud.