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.
# Afficher les informations de partition pour un sujet
Vous pouvez récupérer des informations détaillées sur les partitions d'une rubrique spécifique dans votre cluster MSK Provisioned. Ces informations incluent le numéro de partition, le courtier principal, les courtiers de répliques et les répliques synchronisées (ISR). Cela est utile pour surveiller la distribution des partitions, identifier les partitions sous-répliquées ou résoudre les problèmes de réplication.
**Note**
Cette réponse de l'API reflète les données mises à jour toutes les minutes environ. Pour connaître l'état le plus récent du sujet après avoir apporté des modifications, attendez environ une minute avant de lancer la requête.
**Topics**
+ [Affichez les informations de partition à l'aide du AWS Management Console](describe-topic-partitions-console.md)
+ [Affichez les informations de partition à l'aide du AWS CLI](describe-topic-partitions-cli.md)
+ [Afficher les informations de partition à l'aide de l'API](describe-topic-partitions-api.md)
# Affichez les informations de partition à l'aide du AWS Management Console
1. Connectez-vous à la AWS Management Console console Amazon MSK et ouvrez-la [https://console.aws.amazon.com/msk/chez vous ? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).
1. Dans la liste des clusters, choisissez le nom du cluster qui contient le sujet.
1. Sur la page des détails du cluster, choisissez l'onglet **Rubriques**.
1. Dans la liste des rubriques, choisissez le nom de la rubrique pour laquelle vous souhaitez consulter les informations de partition.
1. Sur la page de détails du sujet, les informations de partition sont affichées, indiquant le numéro de partition, le courtier principal, les répliques et les répliques synchronisées pour chaque partition.
# 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 `--next-token` utilisez-le 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.
# Afficher les informations de partition à l'aide de l'API
Pour consulter les informations de partition à l'aide de l'API, consultez [DescribeTopicPartitions](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname-partitions.html#DescribeTopicPartitions).