를 사용하여 파티션 정보 보기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]
        }
    ]
}

파티션 정보 이해

응답에는 각 파티션에 대한 다음 정보가 포함됩니다.

• 파티션 - 파티션 번호입니다. 파티션은 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 목록을 검사하여 복제를 따라잡는 데 문제가 있는 브로커를 식별합니다.

• 파티션 리밸런싱 계획 - 리밸런싱 작업을 수행하기 전에이 정보를 사용하여 현재 파티션 레이아웃을 이해합니다.