Todos os produtos
Search
Central de documentação

ApsaraMQ for Kafka:Handle inactive topics

Última atualização: Jun 27, 2026

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

Identificar tópicos inativos

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

Métrica

Descrição

Condição de inatividade

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

Geralmente, o valor indica uma data muito antiga

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

Verificar o status do tópico no console

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

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

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

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

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

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

Use as seguintes operações de API para verificar a atividade de todos os tópicos simultaneamente.

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

  2. Chame GetTopicStatus para cada tópico e obtenha o status das mensagens.

  3. Em cada resposta, compare os campos TotalCount e LastTimeStamp com os critérios da tabela anterior. Ignore qualquer tópico em que LastTimeStamp seja 0 ou negativo, pois o timestamp estará indisponí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
  • Você deve determinar se um tópico inativo deve ser excluído.

  • Não recomendamos automatizar a exclusão de tópicos por meio de operações de API. Erros de programação podem causar perdas irreversíveis aos negócios.

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

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

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

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

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

Importante

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