Todos os produtos
Search
Central de documentação

ApsaraMQ for Kafka:Handle inactive topics

Última atualização: Sep 21, 2026

Tópicos inativos — aqueles sem atividade recente de mensagens — ainda consomem recursos. Identifique e exclua esses tópicos para reduzir a quantidade de recursos ocupados na sua instância do ApsaraMQ for Kafka.

Identificar tópicos inativos

Duas métricas determinam se um tópico está inativo:

Métrica

O que indica

Inativo quando

TotalCount

Número total de mensagens armazenadas no broker para este tópico

Na maioria dos casos, o valor é 0

LastTimeStamp

Timestamp da mensagem mais recente

Na maioria dos casos, o valor aponta para um momento muito distante

Se LastTimeStamp for 0 ou um valor negativo, o sistema não recuperou o timestamp. Não considere o tópico como inativo nesse caso.

Verificar o status do tópico no console

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

  2. Na barra de menu superior, selecione uma região. Na página Instances, clique no nome da instância desejada.

  3. No painel de navegação à esquerda, clique em Topics e, em seguida, clique no nome do tópico.

  4. Na página Topic Details, clique na aba Partition Status.

  5. Analise os valores de TotalCount e LastTimeStamp. Se o tópico atender aos critérios de inatividade da tabela anterior, anote o nome do tópico para limpeza.

Verificar o status do tópico por meio de operações de API

Use as operações de API a seguir para verificar a atividade de todos os tópicos de uma só vez.

  1. Chame GetTopicList para recuperar todos os tópicos de uma instância.

  2. Chame GetTopicStatus para cada tópico a fim de obter o status de mensagens correspondente.

  3. Em cada resposta, verifique os campos TotalCount e LastTimeStamp de acordo com os critérios da tabela anterior. Ignore qualquer tópico cujo LastTimeStamp seja 0 ou negativo, pois o timestamp não está disponível.

  4. Registre os nomes de todos os tópicos inativos para limpeza.

Excluir um tópico inativo

Após confirmar que um tópico está inativo e pode ser removido com segurança, exclua-o pelo console.

Aviso
  • Avalie se um tópico inativo precisa ser excluído.

  • Recomendamos que você não automatize a exclusão de tópicos por meio de operações de API. Erros programáticos podem causar perdas irreversíveis ao negócio.

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

  2. Na barra de menu superior, selecione uma região. Na página Instances, clique no nome da instância desejada.

  3. No painel de navegação à esquerda, clique em Topics e, em seguida, clique no nome do tópico.

  4. No canto superior direito da página Topic Details, clique em Delete.

  5. Na caixa de diálogo de confirmação, clique em OK.

Importante

Confirme as informações antes de excluir um tópico.