/locust_exporter

A Locust metrics exporter for Prometheus

Primary LanguageGoApache License 2.0Apache-2.0

Locust Exporter

Prometheus exporter for Locust. This exporter was inspired by mbolek/locust_exporter.

Docker Pulls license

locust_dashboard

Quick Start

This package is available for Docker:

  1. Run Locust (example docker-compose)

  2. Run Locust Exporter

docker run --net=host containersol/locust_exporter

Building and Running

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

Flags

  • 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.

  • 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.

Environment Variables

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.

Grafana

The grafana dashboard has beed published with ID 11985 and was exported to locust_dashboard.json.

Screenshot

locust exporter

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

License

Apache License. Please see License File for more information.