Todos os produtos
Search
Central de documentação

ApsaraMQ for RocketMQ:Gerenciar grupos

Última atualização: Jun 27, 2026

Um grupo identifica instâncias de produtor ou consumidor que processam o mesmo tipo de mensagem com lógica compartilhada. Crie os grupos no console do ApsaraMQ for RocketMQ antes de usar o ApsaraMQ for RocketMQ para produzir ou consumir mensagens.

Limites

  • Cada instância suporta até 1.000 grupos. Reutilize ou exclua grupos não utilizados para permanecer dentro do limite. Para aumentar essa cota, entre em contato com o suporte técnico do ApsaraMQ for RocketMQ.

  • Não é possível usar um grupo em diferentes instâncias.

  • O ApsaraMQ for RocketMQ oferece suporte aos protocolos HTTP e TCP para consumo de mensagens. Grupos distintos podem adotar protocolos diferentes, mas todos os consumidores do mesmo grupo devem usar o mesmo protocolo.

    • A mistura de protocolos em um único grupo pode causar falhas no consumo, duplicação ou perda de mensagens.

    • Alterações de protocolo em um grupo levam aproximadamente de 1 a 2 horas para entrar em vigor.

    • Se o protocolo real diferir daquele exibido no console, os dados do console podem estar imprecisos, embora o envio de mensagens não seja afetado. Entre em contato com o suporte técnico do ApsaraMQ for RocketMQ para atualizar o protocolo exibido.

  • O Group ID é obrigatório para cada consumidor, mas opcional para produtores.

Convenções de nomenclatura para Group IDs

  • O Group ID deve ter entre 2 e 64 caracteres e pode conter letras, dígitos, hifens (-) e sublinhados (_). Prefixo recomendado: GID_ ou GID-.

  • Se a instância tiver um namespace, o Group ID deve ser exclusivo nessa instância e não pode duplicar nenhum Group ID ou nome de tópico existente. Group IDs em instâncias diferentes podem ser iguais.

  • Caso a instância não tenha namespace, o Group ID deve ser globalmente exclusivo em todas as instâncias e regiões da sua conta Alibaba Cloud. Ele não pode duplicar nenhum Group ID ou nome de tópico existente.

Nota

Para verificar se uma instância tem namespace, acesse a página Instance Details no console do Message Queue for Apache RocketMQ e visualize a seção Basic Information.

Criar um grupo de consumidores

  1. Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

  2. Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique no nome da instância que deseja gerenciar.

  3. No painel de navegação à esquerda, clique em Groups.

  4. Na página Groups, selecione um protocolo para o SDK do cliente e clique em Create Group.

    O ApsaraMQ for RocketMQ oferece suporte a TCP e HTTP para SDKs de cliente.

  5. No painel exibido, defina o Group ID e a Description e clique em OK.

Excluir um grupo

Aviso

Após excluir um grupo, as instâncias de consumidor identificadas por esse Group ID param de receber mensagens. Os recursos do grupo são excluídos permanentemente e não podem ser restaurados.

  1. Na página Instances, clique no nome da instância que deseja gerenciar. No painel de navegação à esquerda da página exibida, clique em Groups.

  2. Na lista de grupos, localize o grupo desejado, clique em More na coluna Actions e selecione Delete na lista suspensa.

  3. Na mensagem exibida, clique em OK.

Visualizar os detalhes de um grupo

  1. Na página Instances, clique no nome da instância que deseja gerenciar. No painel de navegação à esquerda da página exibida, clique em Groups.

  2. Na lista de grupos, localize o grupo desejado e clique em seu ID ou em Details na coluna Actions para abrir a página de detalhes do grupo.

Mais operações

A página Groups também permite as seguintes operações:

  1. No painel de navegação à esquerda, clique em Groups.

  2. Na lista de grupos, localize o grupo desejado, clique em More na coluna Actions e selecione uma das seguintes operações na lista suspensa:

  • Quick Access: Consulte as referências de SDK do ApsaraMQ for RocketMQ para diversas linguagens de programação.

  • Reset Consumer Offset: Redefina o offset do consumidor para ignorar mensagens acumuladas ou indesejadas e iniciar o consumo a partir de um novo offset. Também é possível consumir mensagens de um ponto específico no tempo, independentemente do consumo anterior de mensagens. Para mais informações, consulte Redefinir offsets de consumidor.

  • Cloud Monitor: Visualize dados de monitoramento de produção e consumo do grupo.

  • Dashboard: Acompanhe as métricas de consumo do grupo.

Referências

Também é possível gerenciar grupos chamando estas operações de API: