ta4ilka69/Run Locust tests
Run Locust load tests in GitHub Actions with thresholds and artifact uploads
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| locust_file | Path to locust file (e.g., tests/locustfile.py) | yes | — |
| host | Target host, e.g. https://example.com | yes | — |
| users | Number of simulated users (equivalent to -u/--users) | no | "" |
| spawn_rate | Rate to spawn users per second (equivalent to -r/--spawn-rate) | no | "" |
| run_time | Total run time (e.g., 2m, 30s) | no | "" |
| headless | Run in headless mode | no | true |
| tags | Only run tasks with any of these tags (comma-separated) | no | "" |
| exclude_tags | Exclude tasks with any of these tags (comma-separated) | no | "" |
| log_level | Set locust log level (e.g., INFO, DEBUG) | no | INFO |
| additional_args | Additional raw args to append to the locust command | no | "" |
| check_fail_ratio | Fail if (failures/requests) > this ratio (e.g., 0.02) | no | "" |
| check_avg_response_time | Fail if aggregated average response time (ms) > value | no | "" |
| check_p95_response_time | Fail if aggregated 95th percentile response time (ms) > value | no | "" |
| python_version | Python version to use | no | 3.11 |
| locust_version | Locust version specifier (e.g., 2.29.1 or ~=2.29) | no | "" |
| requirements | Path to requirements file to pip install before running | no | "" |
| output_dir | Directory to place reports (HTML and CSVs) | no | locust-report |
| csv_prefix | CSV filename prefix (without path) | no | locust_stats |
| html_report | Generate HTML report | no | true |
| upload_artifacts | Upload reports as workflow artifacts | no | true |
| artifact_name | Artifact name when uploading | no | locust-report |
Outputs
| name | description |
|---|---|
| fail_ratio | Aggregated failure ratio |
| avg_response_time | Aggregated average response time (ms) |
| p95_response_time | Aggregated 95th percentile response time (ms) |
| total_requests | Total number of requests |
| total_failures | Total number of failures |
| thresholds_passed | Whether threshold checks passed |