Mengelola notifikasi pemberitahuan anggaran terprogram

Ringkasan

Perilaku umum anggaran adalah mengirim email pemberitahuan saat aturan nilai minimum pemberitahuan anggaran memicu notifikasi email.

Gambar 1: Menggambarkan fungsi email default untuk notifikasi pemberitahuan anggaran dan metode opsional untuk mengotomatiskan respons kontrol biaya menggunakan Pub/Sub untuk notifikasi terprogram.

Namun, jika Anda menggunakan anggaran sebagai alat kontrol biaya, notifikasi email mungkin bukan metode notifikasi terbaik yang dapat digunakan untuk memastikan tindakan tepat waktu untuk mengontrol biaya Google Cloud Anda. Selain notifikasi email, Anda dapat menggunakan notifikasi terprogram untuk mengotomatiskan respons kontrol biaya. Contoh respons kontrol biaya meliputi:

• Membatasi pembelanjaan Google Cloud Anda dengan menonaktifkan penagihan atau menghentikan resource secara otomatis.
• Meneruskan pesan anggaran ke media lain (seperti Slack).
• Mengontrol penggunaan resource Anda dengan menyesuaikan kuota.

Untuk informasi selengkapnya, lihat Contoh respons kontrol biaya otomatis.

Catatan: Anggaran menggunakan estimasi data Penagihan Cloud yang dapat berubah hingga invoice Anda selesai. Dalam kasus yang jarang terjadi, Anda mungkin melihat penurunan biaya antara notifikasi.

Izin yang diperlukan untuk langkah ini

Bergantung pada apakah Anda mengelola anggaran di tingkat akun Penagihan Cloud, atau Anda adalah pemilik project tanpa peran akun Penagihan Cloud, Anda memerlukan kumpulan izin yang berbeda, yang dijelaskan di bagian berikut.

Jika Anda memantau biaya di tingkat akun penagihan

Jika Anda terutama memantau biaya untuk akun Penagihan Cloud, Anda memerlukan izin di tingkat akun Penagihan Cloud.

Jika memiliki akses terbatas atau tidak memiliki akses ke akun Penagihan Cloud, Anda mungkin memiliki izin yang memadai untuk project yang Anda miliki.

• Untuk create atau mengubah anggaran untuk akun Penagihan Cloud, Anda memerlukan salah satu peran berikut:

  • Billing Account Costs Manager
  • Billing Account Administrator di akun Penagihan Cloud.

• Untuk menetapkan atau mengubah topik Pub/Sub, Anda memerlukan peran Admin Pub/Sub di project target yang berisi topik Pub/Sub.

Jika organisasi Anda menggunakan peran khusus untuk autentikasi, Anda memerlukan izin khusus berikut dalam peran khusus:

• billing.budgets.create di akun Penagihan Cloud, untuk membuat anggaran baru.
• billing.budgets.get dan billing.budgets.list di akun Penagihan Cloud, untuk melihat semua anggaran untuk akun Penagihan Cloud.
• billing.budgets.update di akun Penagihan Cloud, untuk mengubah anggaran yang ada.
• pubsub.topics.setIamPolicy dan pubsub.topics.list di project target yang berisi topik Pub/Sub yang ingin Anda gunakan.

Agar peran kustom dapat mengubah anggaran Penagihan Cloud yang ada untuk menghubungkannya ke topik Pub/Sub yang ada, Anda memerlukan izin khusus berikut:

• billing.budgets.get dan billing.budgets.list di akun Penagihan Cloud, untuk melihat semua anggaran untuk akun Penagihan Cloud.
• billing.budgets.update di akun Penagihan Cloud, untuk mengubah anggaran yang ada.
• pubsub.topics.list di project target yang berisi topik Pub/Sub.

Jika Anda memantau biaya di tingkat project

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika memiliki akses terbatas atau tidak memiliki akses ke akun Penagihan Cloud, Anda dapat mengelola anggaran yang hanya dicakup untuk project yang Anda miliki.

• Untuk membuat, mengubah, atau melihat anggaran untuk project, Anda memerlukan salah satu peran berikut di project:

  • Pemilik Project
  • Editor Project

• Untuk menetapkan atau mengubah topik Pub/Sub, Anda memerlukan peran Admin Pub/Sub di project target yang berisi topik Pub/Sub.

Jika organisasi Anda menggunakan peran khusus untuk autentikasi, Anda memerlukan izin khusus berikut dalam peran khusus:

• resourcemanager.projects.get di project Anda, untuk melihat pengaitan project (seperti akun penagihan yang tertaut) untuk project Anda.
• billing.resourceCosts.get di project Anda (opsional), untuk melihat biaya dan penggunaan project Anda.
• billing.resourcebudgets.read di project Anda, untuk melihat anggaran satu project dari akun penagihan yang dicakup ke project Anda.
• billing.resourcebudgets.write di project Anda, untuk membuat atau mengubah anggaran satu project yang dicakup ke project Anda.
• pubsub.topics.setIamPolicy dan pubsub.topics.list di project target yang berisi topik Pub/Sub yang ingin Anda gunakan.

Izin yang terkait dengan batasan pembatasan domain

Jika Anda menetapkan kebijakan organisasi untuk membatasi pembagian resource berdasarkan domain, Anda mungkin mengalami error saat mencoba menyiapkan topik Pub/Sub atau menghubungkannya ke anggaran Cloud Billing.

Dalam situasi ini, Anda mungkin perlu memaksa akses akun agar berhasil menghubungkan topik Pub/Sub ke anggaran. Untuk memaksa akses akun, lakukan hal berikut:

1. Hapus kebijakan organisasi yang berisi batasan pembatasan domain menggunakan salah satu metode berikut:

   • Menghapus kebijakan organisasi untuk sementara.

     ATAU

   • Ganti kebijakan organisasi untuk project yang berisi topik Pub/Sub.

2. Ikuti langkah-langkah untuk menghubungkan topik Pub/Sub ke anggaran Penagihan Cloud.

3. Aktifkan kembali kebijakan organisasi untuk organisasi atau project (opsional).

Tentang izin Google Cloud

Untuk mengetahui informasi izin Penagihan Cloud selengkapnya, lihat:

• Ringkasan kontrol akses Penagihan Cloud
• Membuat peran khusus untuk Penagihan Cloud
• Memahami peran Identity and Access Management bawaan untuk Penagihan Cloud

Untuk mengetahui informasi izin project Google Cloud selengkapnya, lihat:

• Kontrol akses untuk project dengan IAM
• Referensi peran dasar dan bawaan IAM

Cara menyiapkan dan mengaktifkan notifikasi terprogram Pub/Sub

Untuk mengaktifkan notifikasi terprogram guna menerima pesan Pub/Sub dengan status anggaran saat ini, hubungkan topik Pub/Sub ke anggaran Penagihan Cloud Anda.

Catatan: Anda harus memiliki izin untuk memberikan peran Pub/Sub Publisher pada topik agar Penagihan Cloud dapat memublikasikan pesan ke topik tersebut.

Untuk menghubungkan, mengedit, atau menghapus topik Pub/Sub yang ditautkan ke anggaran, lakukan tindakan berikut:

1. Membuat topik Pub/Sub

Konfigurasi topik Pub/Sub untuk Penagihan Cloud tempat pemberitahuan anggaran Anda dipublikasikan. Jika sudah mengonfigurasi topik Pub/Sub anggaran Penagihan Cloud, Anda dapat menggunakannya kembali untuk semua anggaran, atau membuat topik unik per anggaran.

1. Buka halaman Pub/Sub di konsol Google Cloud.

   Login ke Pub/Sub konsol Google Cloud

2. Pilih project.

   Sebaiknya buat dan gunakan project Google Cloud terpisah untuk menampung semua kebutuhan FinOps dan administrasi penagihan untuk akun Penagihan Cloud, termasuk topik Pub/Sub terkait Penagihan Cloud. Pelajari lebih lanjut manfaat menggunakan project yang berfokus pada FinOps untuk kasus penggunaan administrasi penagihan Anda.

3. Klik CREATE TOPIC.

4. Di kolom Topic ID, berikan nama topik, lalu klik Create topic.

2. Menghubungkan anggaran Penagihan Cloud ke topik Pub/Sub

Untuk menghubungkan anggaran Penagihan Cloud ke topik Pub/Sub, lakukan hal berikut:

1. Anda dapat login ke halaman Anggaran & pemberitahuan di bagian Penagihan di Konsol Google Cloud menggunakan prosedur yang sesuai dengan level akses Anda ke akun Penagihan Cloud

   Pengguna dengan izin Akun Penagihan Cloud

   Hanya pengguna yang memiliki izin level project (Pratinjau)

   Jika memiliki izin akun Penagihan Cloud, Anda dapat memilih dari daftar akun penagihan yang sudah Anda miliki izin aksesnya. Login ke halaman Anggaran & pemberitahuan di Konsol Google Cloud. Buka Anggaran & pemberitahuan Di layar perintah, pilih akun Penagihan Cloud yang ingin Anda kelola anggarannya. Halaman Anggaran & pemberitahuan akan terbuka untuk akun penagihan yang dipilih.

   Jika hanya memiliki izin project, tetapi tidak memiliki izin untuk akun Penagihan Cloud project, Anda harus memilih project sebelum membuka bagian Penagihan. Login ke dasbor Konsol Google Cloud lalu pilih project. Buka Konsol Google Cloud Pilih project yang anggarannya ingin Anda kelola. Selanjutnya, buka Penagihan: Buka Menu navigasi Konsol Google Cloud, lalu pilih Penagihan. Jika diminta untuk memilih akun penagihan yang ingin Anda lihat dan kelola, klik Buka akun penagihan tertaut untuk melihat akun penagihan yang ditautkan ke project yang Anda pilih. Halaman Billing Overview akan terbuka untuk akun Penagihan Cloud yang dipilih. Di bagian Pengelolaan biaya pada menu Navigasi penagihan, pilih Anggaran & pemberitahuan.

2. Jika perlu, buat anggaran. Atau, untuk mengedit anggaran dan aturan pemberitahuan yang ada, klik nama anggaran.

3. Di bagian Tindakan, di Kelola notifikasi, pilih Hubungkan topik Pub/Sub ke anggaran ini.

4. Di kolom Project, klik Select a project, lalu pilih project yang berisi topik Pub/Sub yang telah Anda siapkan. Jika Anda mengikuti rekomendasi di bagian sebelumnya, ini adalah project Google Cloud FinOps atau administrasi penagihan Anda.

5. Di bagian Select a Pub/Sub topic, pilih topik yang ada, atau buat topik baru dengan memilih Create a topic.

   • Jika membuat topik baru, di kolom Topic ID, berikan nama topik, lalu klik Create topic.
   • Setelah dibuat, topik akan dipilih.

6. Klik Simpan.

Format notifikasi

Notifikasi yang dikirim ke topik Pub/Sub terdiri dari dua bagian:

• Atribut: Kumpulan key-value pair yang mendeskripsikan acara.
• Data: String yang berisi objek JSON yang menjelaskan detail pemberitahuan anggaran.

Catatan: Anda dapat menemukan dan menguji contoh notifikasi dengan membaca Contoh respons kontrol biaya otomatis dan menyiapkan fungsi Cloud Run.

Atribut

Atribut adalah key-value pair yang terdapat dalam semua notifikasi yang dikirim oleh Penagihan Cloud ke topik Pub/Sub Anda. Notifikasi selalu berisi serangkaian key-value pair berikut, terlepas dari payload notifikasi.

Nama atribut	Contoh	Deskripsi
billingAccountId	01D4EE-079462-DFD6EC	ID untuk akun Penagihan Cloud yang memiliki anggaran.
budgetId	de72f49d-779b-4945-a127-4d6ce8def0bb	ID untuk pemberitahuan anggaran dalam akun Penagihan Cloud.
schemaVersion	1.0	Versi skema notifikasi.

Data

Untuk skema versi 1.x, detail pemberitahuan anggaran ditampilkan dalam string UTF-8 berenkode base64 yang berisi objek JSON dengan properti berikut:

Data	Contoh	Deskripsi
budgetDisplayName	"My Personal Budget"	Nama yang dapat dibaca manusia yang ditetapkan ke anggaran.
costAmount	140.321	Jumlah biaya yang diakumulasikan. Jenis biaya yang dilacak bergantung pada filter & setelan anggaran.
costIntervalStart	"2021-02-01T08:00:00Z"	Awal periode pemberitahuan anggaran. `costAmount` mencakup biaya untuk penggunaan yang dimulai pada saat ini. Ini adalah hari pertama jangka waktu anggaran (bulan, kuartal, tahun, atau rentang tanggal kustom) selama penggunaan anggaran terjadi.
budgetAmount	152.557	Jumlah yang dialokasikan dalam anggaran.
budgetAmountType	"SPECIFIED_AMOUNT"	Jenis jumlah anggaran. Ini dapat berupa salah satu dari nilai berikut ini: "SPECIFIED_AMOUNT": Jumlah tetap. "LAST_MONTH_COST": Total biaya yang dikeluarkan selama bulan kalender terakhir. "LAST_PERIODS_COST": Biaya yang dikeluarkan selama periode kalender non-bulanan terakhir, seperti kuartal atau tahun.
alertThresholdExceeded	0.9	Batas pemberitahuan biaya aktual tertinggi yang dikonfigurasi terlampaui. Nilai adalah persen dalam format desimal (misalnya, 0,9 adalah 90%). Kunci ini tidak ada jika biaya sebenarnya tidak melebihi nilai minimum.
forecastThresholdExceeded	0.2	Batas pemberitahuan biaya perkiraan tertinggi terlampaui. Nilai adalah persen dalam format desimal (misalnya, 0,2 adalah 20%). Kunci ini tidak ada jika perkiraan biaya tidak melebihi nilai minimum.
currencyCode	"USD"	Mata uang pemberitahuan anggaran. Semua biaya dan jumlah pemberitahuan anggaran dinyatakan dalam mata uang ini.

Jaminan pengiriman notifikasi ke Pub/Sub

Setelah membuat anggaran dan menghubungkannya ke topik Pub/Sub, Anda akan menerima notifikasi terprogram seperti yang dijelaskan di sini:

• Notifikasi anggaran dikirim ke topik Pub/Sub beberapa kali per hari dengan status anggaran Anda saat ini. Ini adalah ritme yang berbeda dengan email pemberitahuan anggaran, yang hanya dikirim saat nilai minimum anggaran terpenuhi.
• Notifikasi Pub/Sub dikirim meskipun akun Penagihan Cloud tidak memiliki penggunaan.
• Mungkin perlu waktu beberapa jam sebelum Anda menerima notifikasi Pub/Sub pertama.
• Pub/Sub hanya menjamin pengiriman minimal satu kali. Anda mungkin menerima pesan beberapa kali, dan pesan mungkin tiba secara tidak berurutan.

• Jika pengiriman gagal karena kesalahan konfigurasi topik Pub/Sub, Anda tidak akan menerima notifikasi.

  Pengiriman mungkin gagal karena salah satu alasan berikut:

  • Topik Pub/Sub tidak lagi ada.
  • Penagihan Cloud tidak lagi memiliki izin untuk memublikasikan ke topik Pub/Sub.
  • Anda telah melampaui kuota notifikasi.