This exporter is forked from the original repo which no longer maintained due to starting RabbitMQ 4, it has its own built-in exporter. In our case, due to dependency with this exporter, we have decided to continue maintain this exporter.
Note: This is a fork of the original kbudde/rabbitmq_exporter maintained by GoPay Tech team.
Prometheus exporter for RabbitMQ metrics. Data is scraped by prometheus.
Please note this is an unofficial plugin. There is also an official plugin from RabbitMQ.com. See comparison to official exporter
You can download the latest release on the release page.
# Latest release
docker pull ghcr.io/gopaytech/rabbitmq_exporter:latest
# Specific version
docker pull ghcr.io/gopaytech/rabbitmq_exporter:v1.0.0
# Development builds
docker pull ghcr.io/gopaytech/rabbitmq_exporter:main# Latest release
docker pull gopaytech/rabbitmq-exporter:latest
# Specific version
docker pull gopaytech/rabbitmq-exporter:v1.0.0Supported Architectures: linux/amd64, linux/arm64, linux/arm/v6, linux/arm/v7
The rabbitmq_exporter is sharing the network interface with the rabbitmq container -> it is possible to use localhost and default user/password (guest).
-
Start rabbitMQ
docker run -d -e RABBITMQ_NODENAME=my-rabbit --name my-rabbit -p 9419:9419 rabbitmq:3-management -
Start rabbitmq_exporter in container.
docker run -d --net=container:my-rabbit ghcr.io/gopaytech/rabbitmq_exporter:latest
Now your metrics are exposed through http://host:9419/metrics. The management plugin does not need to be exposed.
Rabbitmq_exporter can be configured using json config file or environment variables for configuration.
Rabbitmq_exporter expects config file in "conf/rabbitmq.conf". If you are running the exporter in a container (docker/kubernetes) the config must be in "/conf/rabbitmq.conf" The name of the file can be overriden with flag:
./rabbitmq_exporter -config-file config.example.json
You can find an example here. Note: If you are using a config file, you must provide all values as there is no default value.
| Environment variable | default | description |
|---|---|---|
| RABBIT_URL | http://127.0.0.1:15672 | url to rabbitMQ management plugin (must start with http(s)://) |
| RABBIT_USER | guest | username for rabbitMQ management plugin. User needs monitoring tag! |
| RABBIT_PASSWORD | guest | password for rabbitMQ management plugin |
| RABBIT_CONNECTION | direct | direct or loadbalancer, strips the self label when loadbalancer |
| RABBIT_USER_FILE | location of file with username (useful for docker secrets) | |
| RABBIT_PASSWORD_FILE | location of file with password (useful for docker secrets) | |
| PUBLISH_PORT | 9419 | Listening port for the exporter |
| PUBLISH_ADDR | "" | Listening host/IP for the exporter |
| OUTPUT_FORMAT | TTY | Log ouput format. TTY and JSON are suported |
| LOG_LEVEL | info | log level. possible values: "debug", "info", "warning", "error", "fatal", or "panic" |
| CAFILE | ca.pem | path to root certificate for access management plugin. Just needed if self signed certificate is used. Will be ignored if the file does not exist |
| CERTFILE | client-cert.pem | path to client certificate used to verify the exporter's authenticity. Will be ignored if the file does not exist |
| KEYFILE | client-key.pem | path to private key used with certificate to verify the exporter's authenticity. Will be ignored if the file does not exist |
| SKIPVERIFY | false | true/0 will ignore certificate errors of the management plugin |
| SKIP_VHOST | ^$ | regex, matching vhost names are not exported. First performs INCLUDE_VHOST, then SKIP_VHOST. Applies to queues and exchanges |
| INCLUDE_VHOST | .* | regex vhost filter. Only matching vhosts are exported. Applies to queues and exchanges |
| INCLUDE_QUEUES | .* | regex queue filter. Just matching names are exported |
| SKIP_QUEUES | ^$ | regex, matching queue names are not exported (useful for short-lived rpc queues). First performed INCLUDE, after SKIP |
| INCLUDE_EXCHANGES | .* | regex exchange filter. (Only exchanges in matching vhosts are exported) |
| SKIP_EXCHANGES | ^$ | regex, matching exchanges names are not exported. First performed INCLUDE, after SKIP |
| RABBIT_CAPABILITIES | bert,no_sort | comma-separated list of extended scraping capabilities supported by the target RabbitMQ server |
| RABBIT_EXPORTERS | exchange,node,queue | List of enabled modules. Possible modules: connections,shovel,federation,exchange,node,queue,memory |
| RABBIT_TIMEOUT | 30 | timeout in seconds for retrieving data from management plugin. |
| MAX_QUEUES | 0 | max number of queues before we drop metrics (disabled if set to 0) |
| EXCLUDE_METRICS | Metric names to exclude from export. comma-seperated. e.g. "recv_oct, recv_cnt". See exporter_*.go for names |
Example and recommended settings:
SKIP_QUEUES="RPC_.*" MAX_QUEUES=5000 ./rabbitmq_exporter
Newer version of RabbitMQ can provide some features that reduce
overhead imposed by scraping the data needed by this exporter. The
following capabilities are currently supported in
RABBIT_CAPABILITIES env var:
no_sort: By default RabbitMQ management plugin sorts results using the default sort order of vhost/name. This sorting overhead can be avoided by passing empty sort argument (?sort=) to RabbitMQ starting from version 3.6.8. This option can be safely enabled on earlier 3.6.X versions, but it'll not give any performance improvements. And it's incompatible with 3.4.X and 3.5.X.bert: Since 3.6.9 (see rabbitmq/rabbitmq-management#367) RabbitMQ supports BERT encoding as a JSON alternative. Given that BERT encoding is implemented in C inside the Erlang VM, it's way more effective than pure-Erlang JSON encoding. So this greatly reduces monitoring overhead when we have a lot of objects in RabbitMQ.
- has runtime/erlang metrics
- aggregated or per-object metrics
- missing filter
This exporter:
- works also with older versions of rabbitmq
- has more configuration options/ filtering of objects
- (bad) depends on data from management interface which can be slow/delayed
probalby best solution is to use both exporters: comment from shamil
We provide a convenient development script to help with local development:
# Make the script executable (first time only)
chmod +x dev.sh
# Run all checks, tests, and builds
./dev.sh all
# Run individual commands
./dev.sh test # Run tests only
./dev.sh build # Build binary only
./dev.sh docker # Build Docker image only
./dev.sh run # Run locally (after build)
./dev.sh clean # Clean up artifacts# Install dependencies
go mod tidy
# Run tests
go test -v ./...
# Build binary
go build -o rabbitmq_exporter
# Build Docker image
docker build -t gopaytech/rabbitmq-exporter:dev .This repository uses GitHub Actions for automated CI/CD:
- Pull Requests: Run tests, linting, and GoReleaser validation
- Main Branch: Build and push development images to GHCR
- Tags: Create releases with multi-architecture builds
- Security: Weekly vulnerability scanning with Trivy and govulncheck
See .github/ACTIONS.md for detailed documentation.
This exporter expects capabilities from rabbitmq 3.6.8 or newer by default. If you are running older than 3.6.8 you must disable bert and no_sort with the setting RABBIT_CAPABILITIES=compat. If you are running 3.13.0 or newer you must disable no_sort with the setting RABBIT_CAPABILITIES=no_sort.
If there is a load balancer between the exporter and the RabbitMQApi, the setting RABBIT_CONNECTION=loadbalancer must be activated.
See kbudde#131 for details.
This project uses goreleaser to build and release the project. You can build the project with the following command:
goreleaser build --snapshot
go build will also work, but it will not include the version information, uses cgo, etc.
To run the tests, use the following command:
go test -v ./...
If you have docker installed, you can run the tests with the following command:
go test -v ./... --tags integration
This will start a rabbitmq container and run the tests against it.
The metrics are documented in the metrics.md file.