JSCODE Logo
JSCODE 박재성JSCODE 제이온JSCODE 시니
과외유튜브블로그후기
완강 후기 이벤트블로그 리뷰 이벤트AWS SAA 합격 후기 이벤트
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2026 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침

실전에서 바로 써먹는 Kafka 입문

Kafka 사전 지식 / 환경 셋팅

Kafka를 왜 배워야할까?
Kafka란? / 메시지 큐(Message Queue)란?
Kafka 설치할 환경 셋팅하기 (feat. EC2)
AWS EC2에 Kafka 설치/실행하기

Kafka 기본 개념

Kafka의 기본 구성 (Topic, Consumer, Producer)
토픽 생성하기 / 조회하기 / 삭제하기
Kafka에 메시지 넣기 / Kafka에서 메시지 조회하기
메시지를 어디까지 읽었는 지 기억하고, 그 다음 메시지부터 처리하기 (Consumer Group, Offset)
[보충 자료] 토픽, 컨슈머 그룹 이름 짓는 법 (Naming Convention)
[실습] Spring Boot에 Kafka 연결을 위한 코드 추가하기
[실습] Spring Boot로 Kafka에 메시지 넣는 코드 작성하기 (Producer)
[실습] Spring Boot가 Kafka에 메시지 잘 넣는 지 테스트해보기
[실습] Spring Boot로 Kafka에서 메시지 조회하기 (Consumer)
Kafka의 비동기 처리로 인한 성능 이점 느껴보기

Kafka 메시지 처리 실패 시 대처 방법

[실습] Spring Boot로 Kafka에서 처리에 실패한 메시지를 재시도(Retry)하도록 만들기
[실습] Spring Boot로 Kafka에서 재시도조차 실패한 메시지를 따로 보관하기 (DLT, Dead Letter Topic)
[실습] Spring Boot로 재시도조차 실패한 메시지 사후 처리하기

Kafka 메시지 처리 성능 높이기 (병렬 처리)

컨슈머가 메시지를 하나씩만 처리하는 현상
파티션(Partition)이란? / 특징
[실습] Spring Boot로 하나의 파티션에는 정말 하나의 컨슈머만 할당되는 지 확인해보기
특정 토픽의 파티션 수 조회하기 / 설정하기 / 변경하기
[실습] Spring Boot로 여러 개의 파티션에 메시지가 골고루 들어가는 지 확인해보기
[실습] Spring Boot에서 여러 개의 컨슈머로 메시지 병렬적으로 처리하기
[실습] Spring Boot에서 하나의 컨슈머로 메시지 병렬적으로 처리하기
적정 파티션 개수 계산하는 방법
컨슈머가 메시지를 지연 없이 잘 처리하고 있는 지 확인하는 방법 (Consumer Lag)

Kafka 장애 대비하기 (고가용성)

노드(node), 브로커(broker), 컨트롤러(controller), 클러스터(cluster), 레플리케이션(replication)이란?
[실습] kafka 서버 총 3대 셋팅하기
[실습] Kafka 서버 3대가 서로 잘 연동됐는 지 확인하기
토픽 세부 정보 출력값 정보 해석하기 (Isr, Leader, Replicas 등)
[실습] 팔로워 파티션에 메시지를 넣으면 어떻게 될까?
[실습] 리더 파티션에 장애가 발생하면 어떻게 될까? / Kafka 서버 1대가 고장나면 어떻게 될까?
Kafka 서버는 몇 대를 운용하는 게 좋을까?
Spring Boot에 Kafka 서버 3대를 연결해서 사용하는 방법

[프로젝트] MSA 프로젝트에서 Kafka 도입하기

프로젝트 설계
[실습] Spring Boot로 UserService 서버 초기 환경 설정하기
[실습] 회원가입 API 전체 뼈대 만들기
[실습] 회원 가입 비즈니스 로직 짜기
[실습] Spring Boot로 EmailService 서버 초기 환경 설정하기
[실습] 이메일 발송을 처리할 Consumer 로직 짜기
[실습] 프로젝트 구조에 맞게 Kafka 셋팅하기
[실습] 잘 작동하는 지 테스트해보기
← 블로그 목록으로 돌아가기

특정 토픽의 파티션 수 조회하기 / 설정하기 / 변경하기

JSCODE 박재성
JSCODE 박재성
2026. 03. 13.
author
JSCODE 박재성
category
Kafka
createdAt
Dec 6, 2025 05:14 AM
isPublic
isPublic
series
실전에서 바로 써먹는 Kafka 입문
slug
view-set-change-partition-count
type
post
updatedAt
Mar 13, 2026 09:00

✅ 특정 토픽의 파티션 수 조회하기

토픽에 설정된 파티션 수를 조회하려면 이전에 배웠던 특정 토픽의 세부 정보 조회를 할 때 사용하는 명령어를 입력하면 된다.
# 특정 토픽 세부 정보 조회 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic email.send
notion image
  • PartitionCount : 토픽이 가지고 있는 파티션의 총 개수
    • → 별도의 옵션을 주지 않고 토픽을 생성하면 기본적으로 파티션은 1개만 생성된다.
  • Partition : 파티션 번호 (0번 부터 시작)
 
 

✅ 토픽 생성할 때 파티션 수 설정하기

  1. 토픽 생성하기 (+ 파티션 수 설정하기)
    1. # 문법 $ bin/kafka-topics.sh \ --bootstrap-server <kafka 주소> \ --create \ --topic <토픽명> \ --partitions <파티션 수> # 예제 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --create \ --topic test.topic \ --partitions 3
       
  1. 잘 생성됐는 지 확인하기
    1. $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic test.topic
      notion image
      파티션 수가 3개로 잘 설정된 걸 확인할 수 있다.
       
      그림으로 표현하면 다음과 같다.
      notion image
 
 

✅ 기존 토픽의 파티션 수 늘리기

  1. 기존 토픽의 파티션 수 늘리기
    1. # 문법 $ bin/kafka-topics.sh \ --bootstrap-server <kafka 주소> \ --alter \ --topic <토픽명> \ --partitions <변경할 최종 파티션 수> # 예제 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --alter \ --topic test.topic \ --partitions 5
 
  1. 잘 생성됐는 지 확인하기
    1. $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --describe --topic test.topic
      notion image
      파티션 수가 5개로 잘 변경된 걸 확인할 수 있다.
       
 

✅ 기존 토픽의 파티션 수 줄이기

파티션 수를 3개에서 5개로 늘린 걸, 다시 3개로 줄여보자.
$ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --alter \ --topic test.topic \ --partitions 3
notion image
기존 토픽의 파티션 수를 줄이려고 했더니 에러가 발생했다.
 
Kafka에서는 파티션 수를 늘릴 수는 있지만 줄일 수는 없게 만들어놨다. 파티션을 줄이는 과정에서 내부적으로 문제(데이터 손실, 성능 저하 등)가 많이 발생하기 때문이다. 그래서 파티션을 줄이고 싶다면 새로운 토픽을 생성해서 파티션 수를 다시 설정해야 한다. 그리고 기존 토픽을 새로운 토픽으로 마이그레이션 시켜야 한다. 파티션 수를 줄이기 위해 기존 토픽에서 새로운 토픽으로 마이그레이션 시키는 과정이 귀찮기 때문에, 처음 파티션 수를 설정할 때 신중하게 설정하는 걸 권장하는 편이다.
📎
이 글은 실전에서 바로 써먹는 Kafka 입문 강의의 수업 자료 중 일부입니다.