Kafka by Investigation

A hands-on, prediction-first course for Java and Spring Boot developers: five exercises on a real Kafka 3.9 cluster on your own machine, every command verified and its observed output recorded. Solutions stay separate until you have tried.

Download the pack (ZIP) Read the README first

The five exercises

  1. Exercise 01 — First message — is Kafka a queue? what does reading move?portal scenario: first-message
  2. Exercise 02 — Keys and partitions — where records land, what is orderedportal scenario: partition-anatomy
  3. Exercise 03 — Consumer groups — assignment and the live rebalanceportal scenario: consumer-lag-arithmetic
  4. Exercise 04 — Retries and the dead-letter topic — two ways to failportal scenario: idempotent-duplicates · retryable-topic-dlt
  5. Exercise 05 — Capstone — the order investigation, evidence-firstportal scenario: retryable-topic-dlt

Each exercise names its twin in the Labs Portal scenario library (the online "lab exercises") — the pack and the portal teach the same five lessons, one here as files, one there as pages.

Solutions — attempt first

Solutions 01 · 02 · 03 · 04 · 05 (also inside the ZIP). The course only works if your prediction exists before you open these.

Course documents

README.md · COURSE-GUIDE.md · PREREQUISITES.md · SETUP.md · TROUBLESHOOTING.md · VERIFICATION.md · LICENSE-NOTICE.md

Agent guide: AGENTS.md · PROMPTS.md — for coding agents helping a learner (hints before solutions, evidence over opinions).

Honesty

Every exercise was actually run on 2026-11-21 (Kafka 3.9.0, 3-broker KRaft; Spring Boot 3.5.7 / spring-kafka 3.3.10; JDK 25). What could not be verified is labeled UNVERIFIED with the reason — see VERIFICATION.md. This is an educational product, not a certification or a job guarantee.