Halaman ini memberikan beberapa tips pemecahan masalah umum untuk langganan Cloud Storage.
Memeriksa status langganan Cloud Storage
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 berupa tanda centang hijau, langganan tersebut berfungsi dengan baik.
Jika ikonnya adalah tanda seru merah, langganan tersebut dalam status error.
Klik langganan Cloud Storage.
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.
Setelah masalah teratasi, langganan pada akhirnya akan kembali ke status yang baik.
Tidak dapat membuat atau memperbarui langganan
Berikut adalah beberapa masalah umum yang dapat Anda hadapi jika mengalami masalah saat membuat atau memperbarui langganan 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 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 merah
Jika Anda mengedit bucket setelah membuat langganan, tindakan 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 dalam
antrean langganan. Perhatikan bahwa pesan tidak dikirim ke topik yang dihentikan pengirimannya yang dilampirkan, jika dikonfigurasi. Pesan yang tidak terkonfirmasi dipertahankan selama periode 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 di langganan Cloud Storage Anda dapat menyebabkan pesan ditulis ke Cloud Storage, tetapi tidak diselesaikan untuk 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 Anda juga dapat berdampak negatif pada performa. Ukuran file maksimum yang terlalu rendah dapat menyebabkan Pub/Sub membuat banyak objek Cloud Storage dengan hanya sejumlah kecil pesan di setiap objek. Overhead tambahan pembuatan dan penyelesaian objek akan memperlambat pemrosesan pesan. Untuk performa yang lebih baik, sebaiknya tingkatkan setelan ukuran file maksimum untuk langganan Cloud Storage Anda atau hapus batasan ukuran file.
Batasan kuota
Kemungkinan lainnya 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 menemukan error resource_exhausted
.
Tinjau kuota project Anda dan pastikan Anda memiliki kuota yang cukup. Buka IAM & Admin > Quotas dalam project yang berisi
langganan Pub/Sub Anda. Telusuri kuota
pubsub.googleapis.com/regionalpushsubscriber
. Jika mencapai
batas kuota, Anda dapat meminta kuota yang lebih tinggi.
Langganan membuat lebih banyak file daripada yang diharapkan
Untuk meningkatkan skalabilitas, langganan Cloud Storage Anda mungkin ditangani oleh beberapa backend Pub/Sub. Setiap backend menulis ke file Cloud Storage terpisah, sehingga Anda mungkin mengamati bahwa Cloud Storage membuat lebih banyak file daripada yang diharapkan, terutama untuk beban kerja dengan throughput rendah.
Hal ini wajar. Jika ingin mengurangi jumlah file yang dibuat oleh langganan, Anda dapat mempertimbangkan untuk meningkatkan setelan pengelompokan file di langganan untuk memungkinkan file yang lebih besar. Anda juga dapat memproses ulang file dengan membuat komposisi menjadi sejumlah kecil file yang lebih besar.
Langkah selanjutnya
- Jika Anda masih mengalami masalah dengan langganan Cloud Storage, lihat Mendapatkan dukungan.