Skip to content

Performance Testing & Gatling Engineering

Welcome to a modern, end-to-end guide to Performance Engineering Theory and hands-on Load Testing with Gatling. Move systematically from mathematical scalability laws and workload modeling to HTTP & Kafka simulations, APM trace correlation, and automated CI/CD regression gates.

  • Performance Engineering Theory


    Master Little's Law, M/M/1 queuing curves, Universal Scalability Law, Open vs. Closed models, Coordinated Omission, Apdex, and SLI/SLO/Error Budgets.

    Explore Theory

  • Gatling Engine & Java DSL


    Understand Gatling's non-blocking Netty event-loop architecture, virtual user state machines, feeders, response checks, correlation, and distributed clusters.

    Gatling Architecture

  • 8 Self-Contained Labs


    Run real Java 21 simulations against public HTTP endpoints and an embedded Testcontainers Kafka broker—zero cloud credentials or external accounts needed.

    Start the Labs

  • Interactive Mastery Quiz


    Validate your understanding with interactive single-choice, multi-select, and fill-in-the-blank quizzes embedded across chapters and in the final assessment.

    Take the Mastery Quiz


Learning Roadmap

flowchart LR
    T1["1. Foundations & Laws<br/>Metrics • Little's Law • USL<br/>Coordinated Omission"] --> T2["2. Strategy & Architecture<br/>Methodology • Load Shapes<br/>SLOs • Bottlenecks & Capacity"]
    T2 --> T3["3. Gatling Core DSL<br/>Event Loop • Feeders<br/>Checks • Session Correlation"]
    T3 --> T4["4. Hands-On Labs 1–8<br/>HTTP • CRUD • Load Profiles<br/>Embedded Kafka Streaming"]
    T4 --> T5["5. Observability & CI<br/>Datadog APM Traces<br/>Shift-Left Gates & Quiz"]
  1. What is Performance Testing? — Taxonomy of 10 test types & Shift-Left/Right
  2. Key Metrics & Frameworks — Percentiles, HDR Histograms, Apdex, RED/USE/Golden Signals
  3. Mathematical Laws & Queuing — Little's Law & why latency explodes at 80% utilization
  4. Workload Models & Coordinated Omission — Open vs. Closed models
  5. Labs 1–4: HTTP Track — Run your first Gatling simulations & read HTML reports
  • Complete Foundations & Laws (01–04) + Methodology & Architecture (05–09)
  • Master Gatling Framework internals, immutable Session correlation, custom feeders & JVM tuning
  • Execute all 8 HTTP & Kafka Labs locally with Maven & Docker
  • Correlate client metrics with server Datadog APM Traces & Spans
  • Score 90%+ on the Performance Engineering Mastery Quiz

Quick Start

1. Prerequisites

Tool Version Purpose
Java (JDK) 21+ Compiling & running Gatling simulations (java -version)
Maven 3.9+ Executing gatling-maven-plugin (mvn -version)
Docker Recent Required only for embedded Testcontainers Kafka Labs 6–7 (docker info)
uv (or Python 3.12+) Recent Serving & building this MkDocs documentation site (uv --version)

2. Run Your First Gatling Simulation

git clone https://github.com/nitinkc/GatlingLearning.git
cd GatlingLearning

# Run Lesson 1 (HTTP against JSONPlaceholder — no Docker needed)
mvn gatling:test -Dgatling.simulationClass=io.learn.gatling.simulations.http.Sim01_BasicHttp

# Open the generated interactive HTML report (macOS)
open target/gatling/*/index.html

3. Serve Documentation Locally

uv venv .venv
uv pip install -r requirements.txt
uv run mkdocs serve -a 127.0.0.1:8000
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdocs serve -a 127.0.0.1:8000

Curriculum Directory

Performance Theory

Gatling Framework & Observability

Hands-On Labs & Assessment