A Locust metrics exporter for Prometheus
Prometheus exporter for Locust. This exporter was inspired by mbolek/locust_exporter.
This package is available for Docker:
Run Locust (example docker-compose)
Run Locust Exporter
with docker:
docker run --net=host containersol/locust_exporter
or with docker-compose:
version: "3.0"
services:
locust-exporter:
image: containersol/locust_exporter
network_mode: "host"
Modify prometheus.yml
to add target to Prometheus
scrape_configs:
- job_name: 'locust'
static_configs:
- targets: ['<LOCUST_IP>:9646']
Add dashboard to Grafana with ID 11985
The default way to build is:
go get github.com/ContainerSolutions/locust_exporter
cd ${GOPATH-$HOME/go}/src/github.com/ContainerSolutions/locust_exporter/
go run main.go
--locust.uri
Address of Locust. Default is http://localhost:8089
.
--locust.timeout
Timeout request to Locust. Default is 5s
.
--web.listen-address
Address to listen on for web interface and telemetry. Default is :9646
.
--web.telemetry-path
Path under which to expose metrics. Default is /metrics
.
--locust.namespace
Namespace for prometheus metrics. Default locust
.
--log.level
Set logging level: one of debug
, info
, warn
, error
, fatal
--log.format
Set the log output target and format. e.g. logger:syslog?appname=bob&local=7
or logger:stdout?json=true
Defaults to logger:stderr
.
The following environment variables configure the exporter:
LOCUST_EXPORTER_URI
Address of Locust. Default is http://localhost:8089
.
LOCUST_EXPORTER_TIMEOUT
Timeout reqeust to Locust. Default is 5s
.
LOCUST_EXPORTER_WEB_LISTEN_ADDRESS
Address to listen on for web interface and telemetry. Default is :9646
.
LOCUST_EXPORTER_WEB_TELEMETRY_PATH
Path under which to expose metrics. Default is /metrics
.
LOCUST_METRIC_NAMESPACE
Namespace for prometheus metrics. Default locust
.
The grafana dashboard has beed published with ID 11985 and was exported to locust_dashboard.json.
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Apache License. Please see License File for more information.