All Products
Search
Document Center

IoT Platform:Kelola consumer groups

Last Updated:Sep 05, 2026

Consumer group digunakan untuk mengidentifikasi konsumen pesan. Untuk menghubungkan konsumen pesan ke IoT Platform, tambahkan konsumen tersebut ke dalam consumer group sehingga dapat menerima pesan yang diteruskan oleh IoT Platform ke consumer group tersebut. Topik ini menjelaskan cara membuat, melihat, dan menghapus consumer group di Konsol IoT Platform.

Fitur

Anda dapat menggunakan salah satu metode berikut untuk mendengarkan consumer group dan memperoleh pesan yang diteruskan:

  • Konfigurasikan langganan sisi server AMQP: Anda dapat menggunakan langganan sisi server Advanced Message Queuing Protocol (AMQP) untuk berlangganan jenis pesan tertentu yang dikirim oleh semua perangkat dalam suatu produk dan meneruskan pesan tersebut ke consumer group tertentu.

    Untuk informasi selengkapnya mengenai perbedaan antara langganan sisi server dan penerusan data, lihat Perbandingan solusi penerusan data.

  • Konfigurasikan aturan penerusan data: Anda dapat menggunakan fitur penerusan data untuk meneruskan pesan dari topik tertentu ke consumer group AMQP.

Catatan penggunaan

Anda dapat menentukan ID consumer group untuk client AMQP agar client tersebut dapat terhubung ke IoT Platform dan menerima pesan. Untuk informasi selengkapnya, lihat Hubungkan client AMQP.

Satu consumer group dapat berisi hingga 64 client AMQP yang berbagi ID consumer group yang sama. Setelah pesan perangkat dikirim ke IoT Platform, pesan tersebut akan diteruskan ke salah satu client secara acak dalam consumer group tersebut.

Penting

Anda dapat mengonfigurasi beberapa client AMQP untuk satu consumer group. Namun, satu client AMQP tidak dapat memiliki beberapa ID consumer group.

Buat consumer group

  1. Masuk ke IoT Platform atau .

  2. Pada halaman Overview, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

  3. Pada panel navigasi kiri, pilih Server-side Subscription lalu klik tab Consumer Groups.

  4. Klik Create Consumer Group.

  5. Pada kotak dialog Create Consumer Group, masukkan nama kelompok lalu klik OK.

    Nama consumer group harus terdiri dari 4 hingga 30 karakter, hanya boleh berisi huruf, angka, dan garis bawah (_). Setiap karakter Tionghoa atau Jepang dihitung sebagai dua karakter.

Lihat dan pantau consumer groups

Anda dapat melihat laju konsumsi pesan dan jumlah pesan yang terakumulasi pada consumer group. Untuk memantau consumer group, Anda dapat mengonfigurasi aturan peringatan di Konsol Cloud Monitor.

  1. Pada tab Consumer Groups, temukan consumer group yang ingin Anda kelola lalu klik View di kolom Actions.

  2. Pada tab Consumer Group Status, Anda dapat melihat nilai parameter Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages, dan Last Consumed At. Anda juga dapat melihat daftar client yang sedang online.

    Jika jumlah pesan terakumulasi lebih besar dari atau sama dengan 1, klik Clear di sebelah kanan Accumulated Messages untuk menghapus pesan tersebut.

    Catatan

    Setelah consumer group dibuat, pesan mungkin terakumulasi atau tidak, tergantung apakah consumer group tersebut telah diaktifkan.

    • Jika consumer group belum pernah diaktifkan, statusnya offline. Jika Anda mengirim pesan ke consumer group tersebut, tidak ada pesan yang terakumulasi.

    • Jika consumer group pernah diaktifkan lalu dinonaktifkan, statusnya offline. Jika Anda mengirim pesan ke consumer group tersebut, pesan akan terakumulasi.

    Tab Consumer Group Status menampilkan metrik Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages, dan Last Consumed At di area informasi dasarnya. Di bawah metrik tersebut, daftar Online Clients berisi kolom Client ID, Client IP/Port, Last Up Time, Per-Connection Real-time Consumption Rate, dan Per-Connection Accumulated Consumption Rate.

  3. Pada tab Consumer Group Status, klik Alert Settings. Pada panel Create Alert Rule, konfigurasikan aturan peringatan untuk menerima pemberitahuan peringatan serta memantau jumlah pesan terakumulasi dan laju konsumsi pada consumer group.

    Atur parameter Product menjadi IoT Platform-Server subscription. Konfigurasikan parameter lain sesuai kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Konfigurasikan aturan peringatan.

  4. Pada halaman Consumer Group Details, klik Consumption Logs. Pada tab Consumption Logs, Anda dapat melihat detail catatan konsumsi.

Hapus consumer group

Anda dapat menghapus consumer group, tetapi tidak dapat menghapus consumer group default. Setelah consumer group dihapus, semua client dalam kelompok tersebut tidak dapat lagi menerima pesan.

Peringatan

Jika consumer group yang dihapus digunakan dalam subscription, fitur langganan sisi server mungkin menjadi tidak tersedia, sehingga dapat mengganggu bisnis Anda. Lakukan tindakan ini dengan hati-hati.

  1. Putuskan asosiasi subscription. Jika consumer group terkait dengan subscription, Anda harus memutuskan asosiasi subscription tersebut dari consumer group. Jika consumer group tidak memiliki subscription, lewati langkah ini.

    1. Pada tab Consumer Groups, temukan consumer group tersebut lalu klik View di kolom Actions.

    2. Pada tab Subscribed Products di halaman Consumer Group Details, temukan produk yang ingin Anda kelola lalu klik Unsubscribe di kolom Actions. Pada pesan yang muncul, klik OK.

      Catatan

      Jika hanya satu consumer group yang terkait dengan langganan sisi server, aksi unsubscribe tidak tersedia di halaman Consumer Group Details. Anda harus memodifikasi atau menghapus subscription tersebut pada tab Subscriptions di halaman Server-side Subscription.

  2. Pada tab Consumer Groups di halaman Server-side Subscription, temukan consumer group yang ingin Anda kelola lalu klik Delete di kolom Actions. Pada pesan yang muncul, klik OK.

Referensi

Untuk informasi selengkapnya tentang cara menentukan ID consumer group untuk client AMQP dan menggunakan client AMQP untuk menerima pesan, lihat topik-topik berikut:

Operasi API terkait

API

Deskripsi

CreateConsumerGroup

Membuat consumer group yang digunakan untuk membuat langganan sisi server AMQP.

UpdateConsumerGroup

Memodifikasi nama consumer group.

QueryConsumerGroupByGroupId

Menanyakan detail consumer group berdasarkan ID consumer group.

QueryConsumerGroupList

Menanyakan semua consumer group dalam satu Akun Alibaba Cloud atau melakukan pencarian fuzzy berdasarkan nama consumer group.

QueryConsumerGroupStatus

Menanyakan status consumer group saat langganan sisi server AMQP diaktifkan. Informasi status mencakup informasi client online, laju konsumsi pesan, jumlah pesan terakumulasi, dan waktu konsumsi pesan terbaru.

ResetConsumerGroupPosition

Menghapus pesan terakumulasi pada consumer group saat langganan sisi server AMQP diaktifkan.

DeleteConsumerGroup

Menghapus consumer group.