Run performance tests based on Gatling

Provide a complete Gatling performance testing setup for Java Maven projects by adding the required test dependencies and Gatling Maven plugin configuration, creating or guiding Java simulation placement, and explaining how to run simulations and inspect reports.

What is covered in this Skill?

• Add Gatling dependencies and the gatling-maven-plugin to pom.xml
• Project structure: src/test/java for Java simulations and src/test/resources for Gatling configuration, feeders, templates, and logging
• Run simulations with ./mvnw gatling:test
• Select a simulation with -Dgatling.simulationClass=<FullyQualifiedClassName> when multiple simulations exist
• Use ./mvnw gatling:help -Ddetail=true -Dgoal=test to inspect available plugin options
• Review generated Gatling run output and reports under the build output directory

Scope: Use Gatling through the Maven plugin for Java simulations. Prefer project-local Maven wrapper commands when available.

Constraints

Gatling setup must be Maven-based, reproducible, and compatible with Java project conventions. Prefer official Gatling Maven plugin behavior and avoid inventing unsupported command-line options.