기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 주제에 대한 파티션 정보 보기
<a name="msk-describe-topic-partitions"></a>

MSK 프로비저닝 클러스터에서 특정 주제의 파티션에 대한 자세한 정보를 검색할 수 있습니다. 이 정보에는 파티션 번호, 리더 브로커, 복제본 브로커 및 동기화 내 복제본(ISR)이 포함됩니다. 이는 파티션 배포를 모니터링하거나, 덜 복제된 파티션을 식별하거나, 복제 문제를 해결하는 데 유용합니다.

**참고**  
이 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태를 보려면 쿼리하기 전에 약 1분 정도 기다려야 합니다.

**Topics**
+ [

# 를 사용하여 파티션 정보 보기 AWS Management Console
](describe-topic-partitions-console.md)
+ [

# 를 사용하여 파티션 정보 보기 AWS CLI
](describe-topic-partitions-cli.md)
+ [

# API를 사용하여 파티션 정보 보기
](describe-topic-partitions-api.md)

# 를 사용하여 파티션 정보 보기 AWS Management Console
<a name="describe-topic-partitions-console"></a>

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.

1. 클러스터 목록에서 주제가 포함된 클러스터의 이름을 선택합니다.

1. 클러스터 세부 정보 페이지에서 **주제** 탭을 선택합니다.

1. 주제 목록에서 파티션 정보를 보려는 주제의 이름을 선택합니다.

1. 주제 세부 정보 페이지에 파티션 정보가 표시되며 각 파티션의 파티션 번호, 리더 브로커, 복제본 및 동기화된 복제본이 표시됩니다.

# 를 사용하여 파티션 정보 보기 AWS CLI
<a name="describe-topic-partitions-cli"></a>

다음 명령을 실행하여 *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]
        }
    ]
}
```

## 파티션 정보 이해
<a name="describe-topic-partitions-fields"></a>

응답에는 각 파티션에 대한 다음 정보가 포함됩니다.
+ **파티션** - 파티션 번호입니다. 파티션은 0부터 번호가 매겨집니다.
+ **leader** -이 파티션에 대한 리더의 브로커 ID입니다. 리더는 파티션에 대한 모든 읽기 및 쓰기 요청을 처리합니다.
+ **복제본 **-이 파티션의 복제본이 있는 브로커 IDs 목록입니다. 여기에는 동기화 내 복제본과 out-of-sync 복제본이 모두 포함됩니다.
+ **isr** - 동기화된 복제본인 브로커 IDs 목록입니다. 이러한 복제본은 리더와 완전히 연결되며 필요한 경우 리더 역할을 맡을 수 있습니다.

위 예제에서 파티션 2에는 out-of-sync 복제본이 있습니다. `replicas` 목록에는 브로커 2가 포함되지만 `isr` 목록에는 포함되지 않습니다. 이는 브로커 2가이 파티션의 리더와 완전히 연결되지 않았음을 나타냅니다.

## 결과 페이지 매김
<a name="describe-topic-partitions-pagination"></a>

주제에 파티션이 많은 경우 페이지 매김을 사용하여 더 작은 배치로 결과를 검색할 수 있습니다. `--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
```

## 일반 사용 사례
<a name="describe-topic-partitions-use-cases"></a>

파티션 정보 보기는 여러 시나리오에 유용합니다.
+ **과소 복제된 파티션 식별** - `replicas` 및 `isr` 목록을 비교하여 일부 복제본이 동기화되지 않은 파티션을 식별합니다. 이는 성능 문제 또는 브로커 문제를 나타낼 수 있습니다.
+ **파티션 배포 모니터링** - 파티션 리더가 브로커에 고르게 분산되어 있는지 확인하여 로드가 균형 잡힌지 확인합니다.
+ **복제 문제 해결 **- ISR 목록을 검사하여 복제를 따라잡는 데 문제가 있는 브로커를 식별합니다.
+ **파티션 리밸런싱 계획** - 리밸런싱 작업을 수행하기 전에이 정보를 사용하여 현재 파티션 레이아웃을 이해합니다.

# API를 사용하여 파티션 정보 보기
<a name="describe-topic-partitions-api"></a>

API를 사용하여 파티션 정보를 보려면 [DescribeTopicPartitions](https://docs.aws.amazon.com//msk/1.0/apireference/v1-clusters-clusterarn-topics-topicname-partitions.html#DescribeTopicPartitions)를 참조하세요.