Affichez les informations de partition à l'aide du AWS CLI - Amazon Managed Streaming for Apache Kafka
Comprendre les informations de partitionPagination des résultatsCas d’utilisation courants

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Affichez les informations de partition à l'aide du AWS CLI

Exécutez la commande suivante, en la ClusterArn remplaçant par le Amazon Resource Name (ARN) de votre cluster et TopicName par le nom du sujet.

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

La sortie de cette commande ressemble à l'exemple JSON suivant.

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

Comprendre les informations de partition

La réponse inclut les informations suivantes pour chaque partition :

  • partition — Numéro de partition. Les partitions sont numérotées à partir de 0.

  • leader — L'ID de courtier du leader pour cette partition. Le leader gère toutes les demandes de lecture et d'écriture pour la partition.

  • replicas — Liste des courtiers IDs possédant des répliques de cette partition. Cela inclut à la fois la synchronisation et les out-of-sync répliques.

  • isr — Liste des courtiers IDs qui sont des répliques synchronisées. Ces répliques sont entièrement rattachées au leader et peuvent prendre le relais en tant que leader si nécessaire.

Dans l'exemple ci-dessus, la partition 2 possède une out-of-sync réplique. La replicas liste inclut le courtier 2, mais pas la isr liste. Cela indique que le courtier 2 n'est pas complètement rattrapé par le leader pour cette partition.

Pagination des résultats

Si votre sujet comporte de nombreuses partitions, vous pouvez utiliser la pagination pour récupérer les résultats par petits lots. Utilisez le --max-results paramètre pour spécifier le nombre maximal de partitions à renvoyer et utilisez-le --next-token pour récupérer la page de résultats suivante.

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

Si d'autres résultats sont disponibles, la réponse inclut une nextToken valeur. Utilisez ce jeton pour récupérer la page de résultats suivante.

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

Cas d’utilisation courants

L'affichage des informations de partition est utile dans plusieurs scénarios :

  • Identification des partitions sous-répliquées : comparez les isr listes replicas et pour identifier les partitions sur lesquelles certaines répliques ne sont pas synchronisées. Cela peut indiquer des problèmes de performance ou des problèmes de courtier.

  • Surveillance de la distribution des partitions — Vérifiez que les leaders des partitions sont répartis uniformément entre les courtiers afin de garantir une charge équilibrée.

  • Résolution des problèmes de réplication : identifiez les courtiers qui ont du mal à suivre le rythme de la réplication en examinant la liste ISR.

  • Planification du rééquilibrage des partitions : utilisez ces informations pour comprendre la disposition actuelle de la partition avant d'effectuer des opérations de rééquilibrage.