を使用してパーティション情報を表示するAWS CLI - Amazon Managed Streaming for Apache Kafka
パーティション情報について結果のページ分割一般的なユースケース

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用してパーティション情報を表示するAWS CLI

次のコマンドを実行し、ClusterArn をクラスターの Amazon リソースネーム (ARN) に置き換え、TopicName をトピックの名前に置き換えます。

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

このコマンドの出力は、次の JSON の例のようになります。

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

パーティション情報について

レスポンスには、パーティションごとに次の情報が含まれます。

  • partition — パーティション番号。パーティションには 0 から番号が付けられます。

  • leader — このパーティションのリーダーのブローカー ID。リーダーがパーティションに対するすべての読み取りおよび書き込みリクエストを処理します。

  • レプリカ — このパーティションのレプリカを持つブローカー IDs のリスト。これには、同期内レプリカとout-of-syncレプリカの両方が含まれます。

  • isr — 同期レプリカであるブローカー IDs のリスト。これらのレプリカはリーダーに完全に追いついており、必要に応じてリーダーとして引き継ぐことができます。

上記の例では、パーティション 2 にout-of-syncレプリカがあります。replicas リストにはブローカー 2 が含まれていますが、isrリストには含まれていません。これは、ブローカー 2 がこのパーティションのリーダーに完全に追いついていないことを示します。

結果のページ分割

トピックに多数のパーティションがある場合は、ページ分割を使用して小さなバッチで結果を取得できます。--max-results パラメータを使用して返すパーティションの最大数を指定し、 --next-tokenパラメータを使用して結果の次のページを取得します。

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

使用可能な結果が他にもある場合、レスポンスにはnextToken値が含まれます。このトークンを使用して、結果の次のページを取得します。

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

一般的なユースケース

パーティション情報の表示は、いくつかのシナリオで役立ちます。

  • レプリケート不足のパーティションの識別 — replicasと isrリストを比較して、一部のレプリカが同期していないパーティションを識別します。これは、パフォーマンスの問題やブローカーの問題を示している可能性があります。

  • パーティション分散のモニタリング — 負荷のバランスを確保するために、パーティションリーダーがブローカー間で均等に分散されていることを確認します。

  • レプリケーション問題のトラブルシューティング — ISR リストを調べて、どのブローカーがレプリケーションに追いついていないかを特定します。

  • パーティションの再調整の計画 — この情報を使用して、再調整オペレーションを実行する前に現在のパーティションレイアウトを理解します。