Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Melihat informasi partisi untuk topik
<a name="msk-describe-topic-partitions"></a>

Anda dapat mengambil informasi rinci tentang partisi topik tertentu di kluster MSK Provisioned Anda. Informasi ini mencakup nomor partisi, broker pemimpin, broker replika, dan replika in-sync (ISR). Ini berguna untuk memantau distribusi partisi, mengidentifikasi partisi yang kurang direplikasi, atau memecahkan masalah replikasi.

**catatan**  
Respons API ini mencerminkan data yang diperbarui kira-kira setiap menit. Untuk status topik terbaru setelah membuat perubahan, biarkan sekitar satu menit sebelum melakukan kueri.

**Topics**
+ [Lihat informasi partisi menggunakan Konsol Manajemen AWS](describe-topic-partitions-console.md)
+ [Lihat informasi partisi menggunakan AWS CLI](describe-topic-partitions-cli.md)
+ [Melihat informasi partisi menggunakan API](describe-topic-partitions-api.md)

# Lihat informasi partisi menggunakan Konsol Manajemen AWS
<a name="describe-topic-partitions-console"></a>

1. Masuk ke Konsol Manajemen AWS, dan buka konsol MSK Amazon di [https://console.aws.amazon.com/msk/rumah? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

1. Dalam daftar cluster, pilih nama cluster yang berisi topik.

1. Pada halaman detail cluster, pilih tab **Topik**.

1. Dalam daftar topik, pilih nama topik yang ingin Anda lihat informasi partisi.

1. Pada halaman detail topik, informasi partisi ditampilkan, menunjukkan nomor partisi, broker pemimpin, replika, dan replika sinkronisasi untuk setiap partisi.

# Lihat informasi partisi menggunakan AWS CLI
<a name="describe-topic-partitions-cli"></a>

Jalankan perintah berikut, ganti *ClusterArn* dengan Amazon Resource Name (ARN) cluster Anda dan *TopicName* dengan nama topik.

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

Output dari perintah ini terlihat seperti contoh JSON berikut.

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

## Memahami informasi partisi
<a name="describe-topic-partitions-fields"></a>

Tanggapan tersebut mencakup informasi berikut untuk setiap partisi:
+ **partisi** — Nomor partisi. Partisi diberi nomor mulai dari 0.
+ **leader** — ID broker pemimpin untuk partisi ini. Pemimpin menangani semua permintaan baca dan tulis untuk partisi.
+ **replika** — Daftar broker IDs yang memiliki replika partisi ini. Ini termasuk in-sync dan out-of-sync replika.
+ **isr** — Daftar broker IDs yang merupakan replika sinkron. Replika ini sepenuhnya terjebak dengan pemimpin dan dapat mengambil alih sebagai pemimpin jika diperlukan.

Pada contoh di atas, partisi 2 memiliki out-of-sync replika. `replicas`Daftar ini termasuk broker 2, tetapi `isr` daftarnya tidak. Ini menunjukkan bahwa broker 2 tidak sepenuhnya terjebak dengan pemimpin untuk partisi ini.

## Hasil paginating
<a name="describe-topic-partitions-pagination"></a>

Jika topik Anda memiliki banyak partisi, Anda dapat menggunakan pagination untuk mengambil hasil dalam batch yang lebih kecil. Gunakan `--max-results` parameter untuk menentukan jumlah maksimum partisi yang akan dikembalikan, dan gunakan `--next-token` parameter untuk mengambil halaman hasil berikutnya.

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

Jika ada lebih banyak hasil yang tersedia, responsnya mencakup `nextToken` nilai. Gunakan token ini untuk mengambil halaman hasil berikutnya.

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

## Kasus penggunaan umum
<a name="describe-topic-partitions-use-cases"></a>

Melihat informasi partisi berguna untuk beberapa skenario:
+ **Mengidentifikasi partisi yang kurang direplikasi** — Bandingkan `replicas` dan `isr` daftar untuk mengidentifikasi partisi di mana beberapa replika tidak sinkron. Ini dapat menunjukkan masalah kinerja atau masalah broker.
+ **Memantau distribusi partisi** — Periksa apakah pemimpin partisi didistribusikan secara merata di seluruh broker untuk memastikan beban seimbang.
+ **Memecahkan masalah replikasi — Identifikasi** broker mana yang mengalami kesulitan mengikuti replikasi dengan memeriksa daftar ISR.
+ **Perencanaan penyeimbangan kembali partisi** - Gunakan informasi ini untuk memahami tata letak partisi saat ini sebelum melakukan operasi penyeimbangan kembali.

# Melihat informasi partisi menggunakan API
<a name="describe-topic-partitions-api"></a>

Untuk melihat informasi partisi menggunakan API, lihat [DescribeTopicPartitions](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname-partitions.html#DescribeTopicPartitions).