Run performance tests based on JMeter

Provide a complete JMeter performance testing solution by creating the run-jmeter.sh script from the exact template, making it executable, and configuring the project structure for load testing. Supports custom loops, threads, ramp-up, and environment variable overrides.

What is covered in this Skill?

• Create run-jmeter.sh in project root from the exact template (no modifications)
• Project structure: src/test/resources/jmeter/load-test.jmx, target/ for results
• Script options: -l (loops), -t (threads), -r (ramp-up), -g (GUI), -h (help)
• Environment variables: JMETER_LOOPS, JMETER_THREADS, JMETER_RAMP_UP
• Verify JMeter is installed and available before proceeding

Scope: Copy the script template verbatim. Do not modify, interpret, or enhance the template content.

Constraints

JMeter must be installed and available in PATH. If not available, show a message and exit. Use only the exact template for the run-jmeter.sh script.

• PREREQUISITE: Verify JMeter is installed and accessible via jmeter --version before creating the script
• CRITICAL: Copy the run-jmeter.sh template exactly — do not modify, interpret, or enhance
• PERMISSION: Make the script executable with chmod +x run-jmeter.sh
• BEFORE APPLYING: Read the reference for the exact script template and usage instructions

When to use this skill

• Improve the code with JMeter performance testing
• Apply JMeter performance testing
• Refactor the code with JMeter performance testing
• Add JMeter support

Reference

For detailed guidance, examples, and constraints, see references/151-java-performance-jmeter.md.