Spanner Data Boost tunduk pada kuota yang membatasi jumlah panggilan ExecuteStreamingSQL dan StreamingRead serentak yang dieksekusi per project dan per region. Jika jumlah permintaan serentak melebihi kuota, permintaan akan gagal dengan error RESOURCE_EXHAUSTED.
Memeriksa kuota
Untuk memeriksa kuota konkurensi di project Anda, ikuti langkah-langkah berikut:
Buka halaman Quotas di konsol Google Cloud .
Di kolom Filter, masukkan
databoost. Dari daftar, pilih salah satu opsi berikut:- DataBoostQuotaPerProjectPerRegion untuk melihat kuota permintaan serentak Data Boost.
- DataBoostMilliQuotaPerProjectPerRegion untuk melihat kuota permintaan serentak Data Boost dalam mili-operasi.
Pada tabel yang dihasilkan, temukan region Anda dan lihat batas untuk region tersebut.
Memantau penggunaan kuota
Untuk memantau penggunaan kuota, ikuti langkah-langkah berikut:
- Di konsol Google Cloud , buka Monitoring.
Buka Monitoring - Jika Metrics Explorer ditampilkan di menu navigasi, pilih opsi tersebut. Jika tidak, klik Resources, lalu pilih Metrics Explorer.
- Di bagian atas halaman, pilih interval waktu.
- Di menu drop-down Metric, di kolom Filter by resource or metric name, masukkan
consumerdan tekanEnteruntuk mempersempit penelusuran. - Untuk melihat kuota permintaan serentak Data Boost:
- Dalam daftar, pilih Consumer Quota > Quota > Concurrent Quota usage, lalu klik Apply.
- Klik + ADD FILTER untuk membuat filter.
- Di menu drop-down Label 1, pilih quota_metric.
- Di kolom teks Value 1, masukkan atau pilih spanner.googleapis.com/data_boost_quota.
Untuk melihat kuota permintaan serentak Data Boost dalam mili-operasi:
- Dalam daftar, pilih Consumer Quota > Quota > penggunaan kuota kapasitas, lalu klik Apply.
- Klik + ADD FILTER untuk membuat filter.
- Di menu drop-down Label 1, pilih quota_metric.
- Di kolom teks Value 1, masukkan atau pilih spanner.googleapis.com/data_boost_milli_quota.
Metrics explorer menampilkan diagram garis penggunaan kuota menurut region.
Opsional: Di bagian Display, untuk Widget type, pilih diagram batang bertumpuk.
Memantau error dan batas kuota
Untuk memantau error kuota karena kuota permintaan serentak Data Boost, ikuti langkah-langkah berikut:
Di Metrics Explorer, pilih metrik Consumer Quota > Quota > Quota exceeded error.
Tambahkan filter untuk quota_metric yang sama dengan spanner.googleapis.com/data_boost_quota.
Untuk memantau batas kuota mili-operasi permintaan serentak Data Boost, ikuti langkah-langkah berikut:
Di Metrics Explorer, pilih metrik Consumer Quota > Quota > Quota limit.
Tambahkan filter untuk quota_metric sama dengan spanner.googleapis.com/data_boost_milli_quota.
Menyetel pemberitahuan untuk penggunaan Data Boost
Anda dapat membuat kebijakan pemberitahuan yang memberi tahu Anda saat jumlah kueri berpartisi serentak yang meminta Data Boost (panggilan ExecuteStreamingSQL dan StreamingRead serentak) per project dan per region melebihi batas tertentu. Untuk melakukannya,
ikuti langkah-langkah berikut:
- Ikuti petunjuk di bagian Membuat kebijakan pemberitahuan batas metrik.
- Di menu drop-down Select a metric, di kolom Filter by resource or metric name, masukkan
consumerdan tekanEnteruntuk mempersempit penelusuran. Untuk menyetel pemberitahuan tentang penggunaan kuota permintaan serentak Data Boost:
- Dalam daftar Select a metric, pilih Consumer Quota > Quota > Concurrent Quota usage, lalu klik Apply.
- Di bagian Tambahkan filter, klik Tambahkan filter untuk membuat filter.
- Di menu drop-down Filter, pilih quota_metric.
- Di kolom teks Value, masukkan atau pilih spanner.googleapis.com/data_boost_quota, lalu klik Done.
- Lanjutkan dengan membuat kebijakan pemberitahuan dan tetapkan nilai minimum ke beberapa persentase kuota.
Misalnya, jika kuota default adalah 200 dan Anda ingin diberi tahu saat jumlah permintaan serentak mencapai 80% dari jumlah maksimum, masukkan 160 di kolom Threshold value.
Untuk menyetel pemberitahuan tentang penggunaan kuota mili-operasi permintaan serentak Data Boost:
- Dalam daftar Select a metric, pilih Consumer Quota > Quota > Rate Quota usage, lalu klik Apply.
- Di bagian Tambahkan filter, klik Tambahkan filter untuk membuat filter.
- Di menu drop-down Filter, pilih quota_metric.
- Di kolom teks Value, masukkan atau pilih spanner.googleapis.com/data_boost_milli_quota, lalu klik Done.
- Lanjutkan dengan membuat kebijakan pemberitahuan dan tetapkan nilai minimum ke beberapa persentase kuota.
Misalnya, jika kuota default adalah 1.000.000 dan Anda ingin diberi tahu saat mili-operasi permintaan mencapai 80% dari batas, masukkan 800.000 di kolom Threshold value.
Menangani error kuota
Jika tingkat error kuota terlampaui tinggi, saat menggunakan Dataflow dengan Data Boost, sebaiknya sesuaikan jumlah maksimum worker dalam tugas Dataflow Anda untuk menghindari melebihi kuota Data Boost. Anda juga dapat mengajukan permohonan untuk mendapatkan kuota yang lebih tinggi. Workload Anda mungkin dibatasi oleh kuota permintaan serentak Data Boost atau kuota mili-operasi. Anda mungkin perlu meningkatkan kuota mili-operasi setelah meningkatkan kuota permintaan serentak.
Memblokir akun utama agar tidak menggunakan resource Data Boost
Jika satu akun utama secara konsisten melebihi jumlah resource Data Boost yang diperkirakan dapat digunakan, Anda dapat memblokir akun utama tersebut agar tidak menggunakan resource Data Boost dengan mencabut izin Identity and Access Management (IAM) spanner.databases.useDataBoost dari akun utama tersebut. Anda dapat mengotomatiskan pencabutan
izin dengan mengonfigurasi saluran notifikasi pemberitahuan sebagai webhook yang
memanggil Cloud Function. Untuk informasi selengkapnya, lihat topik berikut:
- Membuat saluran notifikasi
- Cloud Run Functions
- Menghapus izin tingkat database
Ubah kebijakan izin untuk kode contoh yang mencabut peran.
Langkah berikutnya
- Pelajari Data Boost di Ringkasan Data Boost.