Memecahkan masalah langganan Cloud Storage

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:

  1. Di Konsol Google Cloud, buka halaman langganan Pub/Sub.

    Buka Langganan

  2. Periksa ikon Status untuk langganan Cloud Storage Anda.

    • Jika ikonnya tanda centang hijau, berarti langganan tersebut sehat.

    • Jika ikonnya adalah tanda seru berwarna merah, langganan akan mengalami status error.

  3. Klik langganan Cloud Storage.

    Halaman detail langganan akan terbuka.

  4. Periksa Status langganan untuk melihat pesan error.

  5. Bergantung pada pesan error-nya, buka bagian yang relevan di halaman ini untuk memecahkan masalah Anda.

Setelah masalah teratasi, langganan akhirnya kembali ke status responsif.

Error membuat atau memperbarui langganan akan menampilkan 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 pesan berikut:

The Cloud Storage bucket specified cannot be found.

Untuk mengatasi masalah ini, buat bucket atau perbarui langganan Cloud Storage Anda agar dapat menggunakan bucket yang ada.

Membuat atau memperbarui langganan akan menampilkan error akun layanan

Jika Anda belum mengonfigurasi akun layanan Pub/Sub dengan izin yang tepat, alur kerja pembuatan atau pembaruan langganan akan menampilkan error. Di konsol Google Cloud, pesannya mirip dengan pesan berikut:

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 mengakibatkan masalah, kolom status langganan akan disetel ke status error.

Di halaman detail langganan, periksa status kolom Subscription state. Kolom Subscription state memberikan error yang lebih spesifik, yang mungkin berupa salah satu dari hal berikut:

  • Bucket not found: Bucket telah dihapus. Buat bucket lagi atau perbarui langganan agar dapat 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.

Ketika langganan Pub/Sub berada dalam status error, pesan tidak ditulis ke bucket dan tetap berada di backlog langganan. Perlu diperhatikan bahwa pesan tidak dikirim ke topik yang dihentikan pengirimannya, jika dikonfigurasi. Pesan yang tidak dikonfirmasi akan dipertahankan selama periode yang ditetapkan dalam 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, sebaiknya gunakan spektrum kunci pengurutan yang lebih luas saat memublikasikan pesan, atau nonaktifkan 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 rendah dapat menyebabkan Pub/Sub membuat banyak objek Cloud Storage dengan hanya sedikit pesan di setiap objek. Overhead tambahan saat membuat dan menyelesaikan objek akan 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.

Langganan membuat lebih banyak file dari 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 file lebih banyak dari yang diharapkan, terutama untuk beban kerja throughput rendah.

Hal ini wajar. 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 melakukan pascapemrosesan pada file dengan menulisnya menjadi file yang lebih kecil dan lebih besar.

Langkah selanjutnya