RabbitMQ Munin Plugin
A simple plugin for munin to monitor the number of messages in a queue.
By default monitors the celery queue for the user 'guest'
Features
This plugin monitor the following stats:
- Queue Size (depth), number of messages in the queue.
- Published Messages, number of messages that have been pushed into the queue,
- Published Messages Rate, number of messages per seconds pushed into the queue.
- Channels, number of channels open.
- Connections, number of connections.
- Consumers, number of consumers.
- Exchanges, number of exchanges.
- Queues, number of queues.
Installation
The easiest way to install the code is to use pip.
Install the newest version from PyPI.:
pip install rabbitmq-munin
Install the latest development version:
pip install git+https://github.com/freyes/rabbitmq_munin.git#egg=rabbitmq-munin
The other option is to download and uncompress the code manually and execute the included setup.py script for installation:
./setup.py install
To make the plugin available to the munin-node you can run the following commands:
ln -s $(which rabbitmq_munin) /etc/munin/plugins/ ln -s $(which rabbitmq_munin_pubmsgs) /etc/munin/plugins/
Once munin can run the plugin, you can configure it as any other munin plugin (in /etc/munin/plugin-conf.d/munin-node) and the config will look like this:
[rabbitmq_munin*] env.username guest env.password guest env.server localhost:15672 env.vhost / env.queue celery
The config above is using the default values of the plugin, your environment may require different values.
Dependencies
Python packages:
Rabbitmq plugins:
-
Management Plugin, you can install it with the following command:
rabbitmq-plugins enable rabbitmq_management