Visualizza le informazioni sulla partizione utilizzando il AWS CLI

Esegui il comando seguente, sostituendolo ClusterArn con l'Amazon Resource Name (ARN) del cluster e TopicName con il nome dell'argomento.

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

L'output di questo comando è simile all'esempio JSON seguente.

{
    "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]
        }
    ]
}

Comprensione delle informazioni sulla partizione

La risposta include le seguenti informazioni per ogni partizione:

• partizione: il numero della partizione. Le partizioni sono numerate a partire da 0.

• leader: l'ID del broker del leader per questa partizione. Il leader gestisce tutte le richieste di lettura e scrittura per la partizione.

• repliche: l'elenco dei broker IDs che dispongono di repliche di questa partizione. Ciò include sia le repliche in-sync che quelle in-sync. out-of-sync

• isr: l'elenco dei broker IDs che sono repliche sincronizzate. Queste repliche sono pienamente in contatto con il leader e possono subentrare come leader, se necessario.

Nell'esempio precedente, la partizione 2 ha una out-of-sync replica. L'replicaselenco include il broker 2, ma l'isrelenco no. Ciò indica che il broker 2 non è completamente al passo con il leader di questa partizione.

Impaginazione dei risultati

Se l'argomento ha molte partizioni, puoi utilizzare l'impaginazione per recuperare i risultati in batch più piccoli. Utilizzate il --max-results parametro per specificare il numero massimo di partizioni da restituire e utilizzate il --next-token parametro per recuperare la pagina successiva di risultati.

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

Se sono disponibili più risultati, la risposta include un nextToken valore. Usa questo token per recuperare la pagina successiva di risultati.

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

Casi di utilizzo comune

La visualizzazione delle informazioni sulle partizioni è utile per diversi scenari:

• Identificazione delle partizioni poco replicate: confronta isr gli elenchi replicas and per identificare le partizioni in cui alcune repliche non sono sincronizzate. Ciò può indicare problemi di prestazioni o problemi di broker.

• Monitoraggio della distribuzione delle partizioni: verifica che i leader delle partizioni siano distribuiti uniformemente tra i broker per garantire un carico bilanciato.

• Risoluzione dei problemi di replica: identifica quali broker hanno problemi a tenere il passo con la replica esaminando l'elenco ISR.

• Pianificazione del ribilanciamento delle partizioni: utilizzate queste informazioni per comprendere il layout corrente delle partizioni prima di eseguire le operazioni di ribilanciamento.