# Gatling

> Gatling load testing for APIs. Use for load testing.

- Skill: `g1joshi/gatling` (Agent Skill)
- Install (CLI): `npx skillmds@latest add g1joshi/gatling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/g1joshi/gatling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: G1Joshi (https://skillmd.com/u/g1joshi)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/g1joshi/gatling

---


# Gatling

Gatling is a powerful load testing tool. It is designed for ease of use, maintainability, and high performance. It uses an asynchronous (Akka/Netty) architecture that allows generating huge load from a single machine.

## When to Use

- **High Throughput**: When you need to simulate 10k+ users from a single laptop.
- **Complex Scenarios**: The DSL (Domain Specific Language) allows describing very complex user journeys.
- **JVM Shops**: If your team uses Java/Scala/Kotlin.

## Quick Start (Java)

```java
import static io.gatling.javaapi.core.CoreDsl.*;
import static io.gatling.javaapi.http.HttpDsl.*;

public class BasicSimulation extends Simulation {

  HttpProtocolBuilder httpProtocol = http
    .baseUrl("http://computer-database.gatling.io")
    .acceptHeader("application/json");

  ScenarioBuilder scn = scenario("BasicSimulation")
    .exec(http("request_1").get("/computers"));

  {
    setUp(
      scn.injectOpen(atOnceUsers(10))
    ).protocols(httpProtocol);
  }
}
```

## Core Concepts

### Simulation

The definition of the load test. Contains the HTTP configuration, the _Scenario_ (steps users take), and the _Injection Profile_ (how users arrive).

### Feeders

Mechanisms to inject data (valid usernames, search terms) from CSV/JSON into the virtual users so they don't all look identical.

## Best Practices (2025)

**Do**:

- **Use the Java/Kotlin DSL**: Scala was the default, but Java/Kotlin SDKs are now first-class and easier for most teams.
- **Record User Journeys**: Use the Gatling Recorder (proxy) to capture browser interactions, then clean up the code.

**Don't**:

- **Don't ignore reports**: Gatling generates beautiful HTML reports at the end. Open `index.html` to see the response time distribution graphs.

## References

- [Gatling Documentation](https://gatling.io/docs/gatling/)