Skip to content

Simple server that scrapes HAProxy stats and exports them via HTTP for Prometheus consumption

License

Notifications You must be signed in to change notification settings

miguelsorianod/haproxy_exporter

This branch is 126 commits behind prometheus/haproxy_exporter:main.

Folders and files

NameName
Last commit message
Last commit date
Aug 7, 2018
Feb 3, 2014
Sep 17, 2018
Feb 10, 2015
Aug 31, 2016
Jul 27, 2018
Feb 16, 2017
Sep 17, 2018
Jan 22, 2015
Feb 16, 2017
Jul 27, 2018
Jul 27, 2018
Jan 22, 2015
Jun 21, 2018
Jan 23, 2018
Sep 17, 2018
Jul 27, 2018

Repository files navigation

HAProxy Exporter for Prometheus

This is a simple server that scrapes HAProxy stats and exports them via HTTP for Prometheus consumption.

Getting Started

To run it:

./haproxy_exporter [flags]

Help on flags:

./haproxy_exporter --help

For more information check the source code documentation. All of the core developers are accessible via the Prometheus Developers mailinglist.

Usage

HTTP stats URL

Specify custom URLs for the HAProxy stats port using the --haproxy.scrape-uri flag. For example, if you have set stats uri /baz,

haproxy_exporter --haproxy.scrape-uri="http://localhost:5000/baz?stats;csv"

Or to scrape a remote host:

haproxy_exporter --haproxy.scrape-uri="http://haproxy.example.com/haproxy?stats;csv"

Note that the ;csv is mandatory (and needs to be quoted).

If your stats port is protected by basic auth, add the credentials to the scrape URL:

haproxy_exporter  --haproxy.scrape-uri="http://user:[email protected]/haproxy?stats;csv"

You can also scrape HTTPS URLs. Certificate validation is enabled by default, but you can disable it using the --haproxy.ssl-verify=false flag:

haproxy_exporter --no-haproxy.ssl-verify --haproxy.scrape-uri="https://haproxy.example.com/haproxy?stats;csv"

Unix Sockets

As alternative to localhost HTTP a stats socket can be used. Enable the stats socket in HAProxy with for example:

stats socket /run/haproxy/admin.sock mode 660 level admin

The scrape URL uses the 'unix:' scheme:

haproxy_exporter --haproxy.scrape-uri=unix:/run/haproxy/admin.sock

Docker

Docker Repository on Quay Docker Pulls

To run the haproxy exporter as a Docker container, run:

docker run -p 9101:9101 quay.io/prometheus/haproxy-exporter:v0.9.0 --haproxy.scrape-uri="http://user:[email protected]/haproxy?stats;csv"

Development

Go Report Card Code Climate

Building

make build

Testing

Build Status CircleCI

make test

License

Apache License 2.0, see LICENSE.

About

Simple server that scrapes HAProxy stats and exports them via HTTP for Prometheus consumption

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.6%
  • Makefile 1.8%
  • Dockerfile 0.6%