全部产品
Search
文档中心

ApsaraMQ for RocketMQ:Kelola grup

更新时间:Jul 06, 2025

Grup mencakup produsen atau konsumen yang memproduksi atau mengonsumsi pesan dengan tipe yang sama berdasarkan logika serupa. Untuk menggunakan ApsaraMQ for RocketMQ dalam memproduksi atau mengonsumsi pesan, Anda harus membuat grup untuk mengidentifikasi contoh produsen atau konsumen dengan tipe yang sama. Topik ini menjelaskan cara membuat dan menghapus grup di konsol ApsaraMQ for RocketMQ, serta cara melihat detail grup.

Batasan

  • Maksimal 1.000 grup dapat dibuat pada satu instans ApsaraMQ for RocketMQ. Kami menyarankan Anda menggunakan kembali grup atau menghapus grup yang tidak diperlukan sesegera mungkin. Jika Anda ingin meningkatkan batas maksimum grup, hubungi tim dukungan teknis ApsaraMQ for RocketMQ.

  • Sebuah grup tidak dapat digunakan di beberapa instans. Sebagai contoh, grup yang dibuat di Instans A tidak dapat digunakan di Instans B.

  • Dalam ApsaraMQ for RocketMQ, konsumen dapat mengonsumsi pesan melalui protokol HTTP atau TCP. Grup konsumen yang berbeda dapat menggunakan protokol yang berbeda. Namun, kami menyarankan Anda menentukan protokol yang sama untuk semua konsumen dalam satu grup.

    • Jika konsumen dalam grup yang sama mengonsumsi pesan melalui protokol yang berbeda, konsumsi pesan mungkin gagal, menyebabkan duplikasi atau kehilangan pesan.

    • Membutuhkan waktu sekitar 1 hingga 2 jam untuk mengubah protokol yang digunakan oleh konsumen dalam grup untuk mengonsumsi pesan.

    • Jika konsumen dalam grup mengonsumsi pesan melalui protokol yang berbeda dari protokol yang ditampilkan di konsol ApsaraMQ for RocketMQ, data yang ditampilkan di konsol mungkin tidak akurat. Hal ini tidak memengaruhi pengiriman pesan dalam grup. Dalam kasus ini, Anda dapat menghubungi tim dukungan teknis ApsaraMQ for RocketMQ untuk mengubah protokol yang ditampilkan di konsol menjadi protokol yang digunakan oleh konsumen dalam grup.

  • ID grup harus ditentukan untuk setiap konsumen. Anda tidak perlu menentukan ID grup untuk setiap produsen.

Konvensi penamaan untuk ID grup

  • ID grup harus memiliki panjang 2 hingga 64 karakter dan dapat berisi huruf, angka, tanda hubung (-), serta garis bawah (_). Kami menyarankan Anda menyertakan awalan GID_ atau GID- dalam ID grup.

  • Jika instans tempat grup tersebut berada memiliki namespace, ID grup harus unik di dalam instans. ID grup tidak boleh sama dengan ID grup atau nama topik yang sudah ada di instans. ID grup dan nama topik di instans yang berbeda bisa sama. Sebagai contoh, ID grup di Instans A bisa sama dengan ID grup atau nama topik di Instans B.

  • Jika instans tempat grup tersebut berada tidak memiliki namespace, ID grup harus unik secara global di seluruh instans dan wilayah. ID grup tidak boleh sama dengan ID grup atau nama topik yang sudah ada di ApsaraMQ for RocketMQ di akun Alibaba Cloud Anda.

Catatan

Anda dapat memeriksa apakah sebuah instans memiliki namespace di bagian Basic Information pada halaman Instance Details di konsol ApsaraMQ for RocketMQ.

Buat grup konsumen

  1. Masuk ke Konsol ApsaraMQ for RocketMQ. Di panel navigasi di sisi kiri, klik Instances.

  2. Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou). Pada halaman Instans, klik nama instans yang ingin Anda kelola.

  3. Di panel navigasi di sisi kiri, klik Groups.

  4. Di halaman Groups, pilih protokol untuk SDK klien Anda dan klik Create Group.

    ApsaraMQ for RocketMQ mendukung TCP dan HTTP untuk SDK klien.

  5. Di panel yang muncul, konfigurasikan parameter ID Grup dan Description, lalu klik OK.

Hapus grup

Peringatan

Setelah Anda menghapus grup, contoh konsumen yang diidentifikasi oleh ID grup akan berhenti menerima pesan. Sumber daya dalam grup juga dihapus dan tidak dapat dipulihkan. Berhati-hatilah saat menghapus grup.

  1. Pada halaman Instances, klik nama instans yang ingin Anda kelola. Di panel navigasi di sisi kiri halaman yang muncul, klik Groups.

  2. Dalam daftar grup, temukan grup yang ingin Anda kelola, klik More di kolom Actions, lalu pilih Delete dari daftar drop-down.

  3. Dalam pesan yang muncul, klik OK.

Lihat detail grup

  1. Pada halaman Instances, klik nama instans yang ingin Anda kelola. Di panel navigasi di sisi kiri halaman yang muncul, klik Groups.

  2. Dalam daftar grup, temukan grup yang ingin Anda kelola. Lalu, klik ID grup atau Details di kolom Actions yang sesuai dengan grup untuk masuk ke halaman Detail Grup.

Operasi lainnya

Pada halaman Groups, Anda juga dapat melakukan operasi berikut:

  1. Di panel navigasi di sisi kiri, klik Groups.

  2. Dalam daftar grup, temukan grup yang ingin Anda kelola, klik More di kolom Actions, lalu pilih salah satu operasi berikut dari daftar drop-down:

  • Quick Access: Lihat referensi yang disediakan oleh ApsaraMQ for RocketMQ untuk SDK dalam berbagai bahasa pemrograman.

  • Reset Consumer Offset: Reset offset konsumen untuk melewati pesan yang terakumulasi atau tidak diinginkan dan mulai mengonsumsi pesan dari offset baru. Anda juga dapat mengonsumsi pesan setelah titik waktu tertentu, terlepas dari apakah pesan sebelum titik waktu tersebut telah dikonsumsi. Untuk informasi lebih lanjut, lihat Reset Offset Konsumen.

  • Cloud Monitor: Lihat data pemantauan produksi atau konsumsi pesan dalam grup.

  • Dashboard: Lihat statistik metrik konsumsi grup.

Referensi

Anda dapat memanggil operasi API berikut untuk mengelola grup: