Halaman ini memberikan beberapa tips pemecahan masalah umum untuk langganan Cloud Storage.
Memeriksa status langganan penyimpanan Cloud
Untuk memeriksa status langganan, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman langganan Pub/Sub.
Periksa ikon Status untuk langganan Cloud Storage Anda.
Jika ikonnya adalah tanda centang hijau, berarti langganan berfungsi dengan baik.
Jika ikonnya adalah tanda seru merah, berarti langganan dalam status error.
Klik langganan penyimpanan cloud.
Halaman detail langganan akan terbuka.
Periksa Status langganan untuk melihat pesan error.
Bergantung pada pesan error, buka bagian yang relevan di halaman ini untuk memecahkan masalah tersebut.
Setelah masalah teratasi, langganan akan kembali ke status normal.
Tidak dapat membuat atau memperbarui langganan
Berikut adalah beberapa masalah umum yang dapat Anda hadapi jika mengalami masalah saat membuat atau memperbarui langganan penyimpanan Cloud Storage.
Error bucket tidak ditemukan
Jika bucket yang Anda tentukan dalam alur kerja pembuatan atau pembaruan langganan tidak ada, alur kerja akan menampilkan error bucket not found.
Di konsol Google Cloud , pesannya mirip dengan berikut ini:
The Cloud Storage bucket specified cannot be found.
Untuk mengatasi masalah ini, buat bucket atau perbarui langganan penyimpanan Cloud Storage Anda untuk menggunakan bucket yang ada.
Terjadi error pada akun layanan
Jika Anda belum mengonfigurasi akun layanan Pub/Sub dengan izin yang tepat, maka alur kerja pembuatan atau pembaruan langganan akan menampilkan error. Di konsol Google Cloud , pesannya mirip dengan berikut ini:
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
Untuk mengatasi masalah ini, periksa apakah akun layanan memiliki izin yang benar.
Status langganan menampilkan tanda seru berwarna merah
Jika Anda mengedit bucket setelah membuat langganan, hal ini dapat memengaruhi cara Pub/Sub menulis pesan ke bucket. Jika perubahan menyebabkan masalah, kolom status langganan akan ditetapkan ke status error.
Di halaman detail langganan, periksa status kolom Subscription state.
Kolom Subscription state memberikan error yang lebih spesifik,
yang mungkin salah satu dari berikut:
Bucket tidak ditemukan: Bucket telah dihapus. Buat bucket lagi atau perbarui langganan untuk menggunakan bucket yang ada.
Izin bucket ditolak: Akun layanan Pub/Sub tidak lagi memiliki izin untuk menulis ke bucket. Periksa apakah akun layanan memiliki izin yang benar.
Saat langganan Pub/Sub dalam status error,
pesan tidak ditulis ke bucket dan tetap berada di
backlog langganan. Perhatikan bahwa pesan tidak dikirim ke
topik yang dihentikan pengirimannya yang dilampirkan,
jika dikonfigurasi. Pesan yang tidak terkonfirmasi dipertahankan
selama jangka waktu yang ditetapkan di message_retention_duration (7 hari secara default).
Langganan memproses pesan dengan sangat lambat
Beberapa setelan langganan dapat memperlambat pemrosesan pesan.
Misalnya, mengaktifkan pengurutan pesan pada langganan Cloud Storage dapat menyebabkan pesan ditulis ke Cloud Storage, tetapi tidak diselesaikan, sehingga menunda pesan berikutnya dengan kunci pengurutan yang sama. Untuk performa yang lebih baik, pertimbangkan untuk menggunakan spektrum kunci pengurutan yang lebih luas saat memublikasikan pesan, atau menonaktifkan pengurutan pesan jika kasus penggunaan Anda tidak memerlukannya.
Menetapkan ukuran file maksimum yang terlalu rendah untuk langganan Cloud Storage juga dapat berdampak negatif pada performa. Ukuran file maksimum yang terlalu kecil dapat menyebabkan Pub/Sub membuat banyak objek Cloud Storage dengan hanya sedikit pesan di setiap objek. Overhead tambahan untuk membuat dan menyelesaikan objek memperlambat pemrosesan pesan. Untuk performa yang lebih baik, pertimbangkan untuk meningkatkan setelan ukuran file maksimum untuk langganan Cloud Storage Anda atau menghapus batasan ukuran file.
Batasan kuota
Kemungkinan lain adalah project Anda telah mencapai kuota throughput push Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber).
Untuk memeriksa apakah Anda mengalami batasan kuota, periksa metrik permintaan push (subscription/push_request_count)
untuk mengetahui apakah ada error resource_exhausted.
Tinjau kuota project Anda dan pastikan kuota yang tersisa cukup. Buka IAM & Admin > Quotas dalam project yang berisi langganan Pub/Sub Anda. Telusuri kuota
pubsub.googleapis.com/regionalpushsubscriber. Jika Anda mencapai
batas kuota, Anda dapat
meminta penyesuaian kuota.
Langganan membuat lebih banyak file dari yang diperkirakan
Untuk memungkinkan peningkatan skalabilitas, langganan Cloud Storage Anda mungkin ditangani oleh beberapa backend Pub/Sub. Setiap backend menulis ke file Cloud Storage terpisah, sehingga Anda mungkin melihat Cloud Storage membuat lebih banyak file dari yang diharapkan, terutama untuk beban kerja dengan throughput rendah.
Hal ini adalah perilaku normal. Jika ingin mengurangi jumlah file yang dibuat oleh langganan, Anda dapat mempertimbangkan untuk meningkatkan setelan pengelompokan file pada langganan untuk memungkinkan file yang lebih besar. Anda juga dapat memproses file setelahnya dengan menyusun file tersebut menjadi lebih sedikit file yang lebih besar.
Langkah berikutnya
- Jika Anda masih mengalami masalah dengan langganan Cloud Storage, lihat Mendapatkan dukungan.