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 셋팅하기
[실습] 잘 작동하는 지 테스트해보기
← 블로그 목록으로 돌아가기

[실습] Spring Boot가 Kafka에 메시지 잘 넣는 지 테스트해보기

JSCODE 박재성
JSCODE 박재성
2026. 03. 13.
author
JSCODE 박재성
category
Kafka
createdAt
Dec 6, 2025 02:14 PM
isPublic
isPublic
series
실전에서 바로 써먹는 Kafka 입문
slug
practice-test-producer
type
post
updatedAt
Mar 13, 2026 09:00

✅ 깔끔한 테스트를 위해 기존에 생성되어 있는 Kafka 리소스 삭제하기

  1. 전체 토픽 조회하기
    1. # 전체 토픽 조회하기 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --list
      notion image
      토픽을 조회해보면 이전에 생성했던 email.send 토픽이 조회되는 걸 확인할 수 있다.
       
  1. 토픽 삭제하기
    1. 이전에 생성했던 email.send 토픽을 삭제하자.
      # 토픽 삭제 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --delete --topic email.send # 잘 삭제됐는 지 확인하기 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --list
       
  1. 전체 컨슈머 그룹 조회하기
    1. # 전체 컨슈머 그룹 조회하기 $ bin/kafka-consumer-groups.sh \ --bootstrap-server localhost:9092 \ --list
      notion image
       
  1. 컨슈머 그룹 삭제하기
    1. 이전에 생성했던 email-send-group이라는 컨슈머 그룹을 삭제하자.
      # 컨슈머 그룹 삭제 $ bin/kafka-consumer-groups.sh \ --bootstrap-server localhost:9092 \ --delete \ --group email-send-group # 잘 삭제됐는 지 확인하기 $ bin/kafka-consumer-groups.sh \ --bootstrap-server localhost:9092 \ --list
       
  1. 토픽 다시 생성하기
    1. email.send 토픽에 메시지를 넣어서 테스트를 해봐야하기 때문에 email.send 토픽을 다시 생성해주자.
      # 토픽 생성 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --create --topic email.send # 토픽 잘 생성됐는 지 확인하기 $ bin/kafka-topics.sh \ --bootstrap-server localhost:9092 \ --list
 
 

✅ Spring Boot가 Kafka에 메시지 잘 넣는 지 테스트해보기

  1. Spring Boot 서버 실행시키기
    1. notion image
       
  1. API 요청 보내기
    1. API 요청을 보내서 Kafka에 메시지가 잘 들어가는 지 확인해보자. 요청을 보낼 때 Postman이라는 툴을 활용할 것이다. 다른 API 요청 툴이 있다면 꼭 Postman을 쓰지 않아도 된다.
      notion image
      요청을 보낸 뒤에 성공적으로 응답이 날라온 것까지 확인했다.
       
  1. Kafka의 email.send 토픽에 메시지가 잘 들어갔는 지 확인하기
    1. $ bin/kafka-console-consumer.sh \ --bootstrap-server localhost:9092 \ --topic email.send \ --from-beginning
      notion image
      토픽으로부터 메시지가 잘 조회되는 걸로 봐서 Kafka의 email.send 토픽에 메시지가 잘 들어갔다는 걸 알 수 있다.
       
       

✅ 그림 보면서 전체 흐름 정리하기

notion image
API 요청을 통해 Producer 역할을 하는 Spring Boot 서버에 요청을 보낸다. 그랬더니 Spring Boot에서 메시지 객체를 만들어, 이 객체를 Json 형태의 String 타입으로 변환시켜준 뒤 Kafka의 email.send 토픽으로 전달했다. 그러고 Kakfa에 메시지가 잘 전달되었는 지 CLI로 확인해봤더니 메시지가 잘 전달된 걸 확인할 수 있었다.
 
👨🏻‍🏫
그럼 다음 강의에서는 전체 흐름 중에서 아직 구현하지 않은 Kafka의 메시지를 처리하는 Consumer 서버를 만들어보자.
📎
이 글은 실전에서 바로 써먹는 Kafka 입문 강의의 수업 자료 중 일부입니다.