Metadata-Version: 2.1
Name: locust-influx
Version: 0.2.4a1
Summary: Report locust metrics to influxdb.
Home-page: https://github.com/lucrib/locust_influx
Author: Lucas Ribeiro
Author-email: lucasribeiro1990@gmail.com
License: Apache-2.0
Project-URL: Documentation, https://locust_influx.github.io
Project-URL: Source, https://github.com/lucrib/locust_influx
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: locustio (>=0.12.2)
Requires-Dist: influxdb (>=5.2.2)

# locust_influx

Send information about [locust](https://locust.io/) requests 
to [InfluxDB](https://www.influxdata.com/products/influxdb-overview/) 
and follow the progress through [Grafana](https://grafana.com/) charts.

## Test and taste it locally

Start an InfluxDB container locally:

`docker run -d --name influxdb -d -p 8086:8086 influxdb`

Start a Grafana container locally:

`docker run -d --name grafana -d -p 3000:3000 grafana/grafana`

Crete a new [python virtual environment](https://docs.python.org/3/tutorial/venv.html) and install `locust_influx`:

`pip install locust_influx`

Run the example locustfile contained in this repo (Change the host to point to desired one):

`locust -f ./locustfile.py --no-web --clients 10 --hatch-rate 1 --run-time 60s --host http://localhost:8080`

Open your local Grafana in the browser at [http://localhost:3000/](http://localhost:3000/)

Import the example dashboard from `locust_dashboard.json` file.

![Locust dashboard in grafana](https://raw.githubusercontent.com/lucrib/locust_influx/master/dashboard.png)


