jmeter-ec2
A shell script that automates distributed load testing by running Apache JMeter tests on Amazon EC2 instances or custom host lists.
What is jmeter-ec2?
JMeter-ec2 is a shell script that automates running Apache JMeter load tests on Amazon EC2 instances or custom host lists. It solves the problem of manually setting up and managing distributed load testing infrastructure by handling instance provisioning, test distribution, and results aggregation. The script enables scalable performance testing without requiring deep AWS or JMeter distributed mode expertise.
Performance testers, QA engineers, and developers who need to run distributed load tests with Apache JMeter, particularly those using AWS infrastructure or requiring scalable testing environments.
Developers choose JMeter-ec2 because it eliminates manual infrastructure management for distributed testing, provides real-time results aggregation, and supports both cloud (EC2) and on-premises testing scenarios. Its simplicity and automation reduce setup time while enabling cost-effective scaling through Spot Instance support.
Overview
Automates running Apache JMeter on Amazon EC2
Use Cases
Best For
- Running distributed JMeter tests on AWS EC2 without manual instance management
- Load testing applications from multiple geographic locations using cloud instances
- Performance testing with scalable infrastructure that automatically adjusts to available resources
- Cost-effective load testing using AWS Spot Instances
- Testing applications behind firewalls using custom host lists instead of EC2
- Local load testing validation with Vagrant before cloud deployment
Not Ideal For
- Projects requiring compatibility with JMeter 3.x or newer versions for advanced features
- Test plans that depend on dynamic variables for thread counts or file paths
- Environments where automatic cloud instance provisioning is restricted due to security or compliance policies
- Teams needing detailed, real-time control over individual JMeter slave instances during test runs
Pros & Cons
Pros
Handles instance provisioning, configuration, and termination automatically, as described in the EC2 Automation feature, saving significant manual effort in distributed testing setups.
Supports both AWS EC2 and custom host lists via the REMOTE_HOSTS property, enabling testing in cloud or on-premises setups without being locked into AWS.
Allows optional use of AWS Spot Instances by specifying a price parameter, reducing testing costs significantly for scalable loads, with guidance on bidding strategies in the README.
Collates and displays summary results from all hosts during execution using the Generate Summary Results listener, providing immediate feedback without waiting for test completion.
Cons
The README explicitly states 'JMeter V3 is not tested with this script,' making it potentially incompatible with newer JMeter versions and missing modern features or bug fixes.
Prohibits dynamic variables in thread counts and file paths, requiring numeric values only, which limits test flexibility and increases manual adjustments for complex scenarios.
Involves detailed AWS security group configuration and PEM file management, with common connection issues like 'lost connection' that require troubleshooting, as outlined in the README's lengthy error section.
Frequently Asked Questions
Related Projects
jmeter-kubernetesLoad testing as a service (LTaaS) with Apache Jmeter on kubernetes
kangalRun performance tests in Kubernetes cluster with Kangal
Load Testing Pipeline with JMeter, ACI and TerraformScalable cloud load/stress testing pipeline solution with Apache JMeter and Terraform to dynamically provision and destroy the required infrastructure on Azure.
jmeter-k8s-starterkitUltimate starterkit for JMeter in Kubernetes. WIth live test reporting, JMeter monitoring, kubernetes monitoring and mock as a service
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.