mms-gianni / awesome-locust

A collection of resources covering different aspects of Locust load-testing tool usage.

Awesome Locust

A curated collection of resources covering different aspects of load-testing using Locust framework and related stuff: plugins, integrations, testing techniques, DevOps practices, etc.

Locust is an open-source scalable load-testing framework written in Python.

Contents

• Official Resources
• Getting Started
• Tutorials
• Tools
  • Plugins
  • Workers
  • Wrappers
  • Configuration Management
  • Distributed
  • Frameworks
  • CI/CD
  • Reporting
  • Miscellaneous
• Templates
• Trainings & Courses
• Videos
  • Talks
  • Video Tutorials
• Community
• Related
  • Awesome Lists

Official Resources

• Homepage
• Documentation
• Source code

Getting Started

Tutorials

• Locust for JMeter users - A tutorial on using Locust for people familiar with Apache JMeter.
• How do I Locust - A quick overview and random tips for Locust.
• Locust.io experiments - Series of experiments with Locust.

Tools

Plugins

• locust-plugins - A set of useful plugins/extensions for Locust.

Workers

• boomer - A better load generator for Locust, written in Golang.
• locust4j - A load generator for Locust, written in Java.
• swarm - An elegant Java client for Locust.
• node-locust - A Node.js load generator for Locust.
• ably-boomer - Ably load generator for Locust, based on the boomer library.

Wrappers

• invokust - A wrapper for Locust to allow running load tests in Python or on AWS Lambda.
• strezz - A wrapper for stress testing using Locust based on Jest.
• locust-runner - Marketplace extension for running Locust from VS Code IDE.
• stormer - Wrappers for making load test with Locust more convenient.

Configuration Management

• ansible-role-locust - An Ansible role to manage Locust master instances.
• locust_slave - An Ansible role to manage Locust slave instances.
• terraform-aws-locust - Deploy a Locust stress test cluster on AWS based on CoreOS/Docker.

Distributed

• locust-swarm - A tool for launching distributed Locust runs on a set of load generators.
• azure-locust - Run distributed Locust load tests on Azure Container Instances.
• kangal - Run performance tests in Kubernetes cluster using multiple load generators.
• klocust - A command-line tool for managing Locust distributed load testing on Kubernetes.
• zelt - Zalando End-to-end Load Tester, a command-line tool for orchestrating the deployment of Locust in Kubernetes.
• locust-on-azure - Running distributed Locust on Azure Container Instances.

Frameworks

• Taurus - Locust Executor as part of Taurus framework.
• httprunner - A HTTP/S testing framework with reuse of Locust.

CI/CD

• locust-github-action - A GitHub action for load testing using Locust.
• teamcity-locustio - Configurable Locust test runner plugin for JetBrains Teamcity.
• Keptn Locust Service - Keptn integration to performance test application using Locust.

Reporting

• Locust Exporter - A Locust metrics exporter for Prometheus.
• locust-reporter - Generate HTML reports from Locust load test output.
• JtlReporter - Online reporting application to generate performance reports from Locust by either uploading CSV file or streaming data from the test run continuously.

Miscellaneous

• transformer - A command-line tool and Python library to transform/convert web browser sessions (HAR files) into Locust load testing scenarios (locustfile).
• swagger-to-locustfile - A command-line tool to create Locust tasks file (locustfile) from Swagger/OpenAPI spec.

Templates

• stress-test-locust - Template for stress testing with Python, Locust & Docker.

Trainings & Courses

• Performance Testing Using Locust 1.0 - By Udemy.
• Locust Performance Framework Development with Real Project - By Udemy.

Videos

Talks

• An Intro to Load Testing with Locust and Python - Gabriel Boorse @ PyBay 2019.
• Load test your backend with locust.io - Ivan Matellanes @ PyLondinium 2018.
• Load testing with Locust - Kubilay Kahveci @ FOSDEM 2018.
• Performance Testing with Python and Locust - Michael Sluyter @ PyTexas 2017.

Video Tutorials

• Load Testing with Python and Locust.io - Tutorial series by Nicolai Gram.

Community

• locust on Stack Overflow
• @locustio on Twitter
• #locust on Slack

Related

Awesome Lists

• Awesome Software Quality - A list of free software testing and verification resources.
• Awesome Testing - A curated list of testing resources.
• Awesome Page Speed Metrics - Metrics to help understand page speed and user experience.
• Awesome Web Performance Optimization - A curated list of Web Performance Optimization.
• Awesome Scalability - The Patterns of Scalable, Reliable, and Performant Large-Scale Systems.
• Awesome Site Reliability Engineering - A curated list of Site Reliability and Production Engineering resources.
• Awesome JMeter - Open-source load testing and performance measurement tool, written in Java.
• Awesome Gatling - Open-source load and performance testing framework based on Scala, Akka and Netty.
• Awesome Tsung - Open-source multi-protocol distributed load testing tool, developed in Erlang.
• Awesome k6 - Open-source, developer-centric performance monitoring and load testing solution.

Contributing

Contributions are welcome!
Please take a look at the contribution guidelines first.