Visualize as informações da partição usando o AWS CLI - Amazon Managed Streaming for Apache Kafka
Compreendendo as informações de partiçãoComo paginar resultadosCasos de uso comuns

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Visualize as informações da partição usando o AWS CLI

Execute o comando a seguir, ClusterArn substituindo-o pelo Amazon Resource Name (ARN) do seu cluster e TopicName pelo nome do tópico.

aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName

A saída desse comando é semelhante ao seguinte JSON de exemplo.

{
    "partitions": [
        {
            "partition": 0,
            "leader": 1,
            "replicas": [1, 2, 3],
            "isr": [1, 2, 3]
        },
        {
            "partition": 1,
            "leader": 2,
            "replicas": [2, 3, 1],
            "isr": [2, 3, 1]
        },
        {
            "partition": 2,
            "leader": 3,
            "replicas": [3, 1, 2],
            "isr": [3, 1]
        }
    ]
}

Compreendendo as informações de partição

A resposta inclui as seguintes informações para cada partição:

  • partição — O número da partição. As partições são numeradas a partir de 0.

  • líder — O ID do corretor do líder dessa partição. O líder lida com todas as solicitações de leitura e gravação da partição.

  • réplicas — A lista de corretores IDs que têm réplicas dessa partição. Isso inclui tanto a sincronização quanto as out-of-sync réplicas.

  • isr — A lista de corretores IDs que são réplicas sincronizadas. Essas réplicas são totalmente identificadas pelo líder e podem assumir o cargo de líder, se necessário.

No exemplo acima, a partição 2 tem uma out-of-sync réplica. A replicas lista inclui o corretor 2, mas a isr lista não. Isso indica que o broker 2 não está totalmente familiarizado com o líder dessa partição.

Como paginar resultados

Se o seu tópico tiver muitas partições, você poderá usar a paginação para recuperar os resultados em lotes menores. Use o --max-results parâmetro para especificar o número máximo de partições a serem retornadas e use o --next-token parâmetro para recuperar a próxima página de resultados.

aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10

Se houver mais resultados disponíveis, a resposta incluirá um nextToken valor. Use esse token para recuperar a próxima página de resultados.

aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10 --next-token NextToken

Casos de uso comuns

A visualização das informações da partição é útil para vários cenários:

  • Identificação de partições sub-replicadas — Compare as isr listas replicas e para identificar partições em que algumas réplicas não estão sincronizadas. Isso pode indicar problemas de desempenho ou problemas do corretor.

  • Monitoramento da distribuição de partições — Verifique se os líderes de partição estão distribuídos uniformemente entre os corretores para garantir uma carga balanceada.

  • Solução de problemas de replicação — identifique quais corretores estão tendo problemas para acompanhar a replicação examinando a lista de ISR.

  • Planejando o rebalanceamento de partições — Use essas informações para entender o layout atual da partição antes de realizar operações de rebalanceamento.