=========================
 RabbitMQ Munin Plug-Ins
=========================

Screenshots
===========

.. image:: http://cloud.github.com/downloads/ask/rabbitmq-munin/rabbitmq-munin-connections.png

.. image:: http://cloud.github.com/downloads/ask/rabbitmq-munin/rabbitmq-munin-consumers.png

.. image:: http://cloud.github.com/downloads/ask/rabbitmq-munin/rabbitmq-munin-list_queues.png

.. image:: http://cloud.github.com/downloads/ask/rabbitmq-munin/rabbitmq-munin-queue-memory.png

.. image:: http://cloud.github.com/downloads/ask/rabbitmq-munin/rabbitmq-munin-unacknowledged.png

Installation
============

Copy the plug-ins to the munin plugin directory, e.g ``/etc/munin/plugins/``.

Granting Permissions
====================

To use these plug-ins you (regretfully) have to grant access for the
munin-node user to use rabbitmqctl via sudo.

Add this to your ``/etc/sudoers`` file by running ``visudo``::

    muninuser ALL= NOPASSWD: /usr/sbin/rabbitmqctl list_queues *
    muninuser ALL= NOPASSWD: /usr/sbin/rabbitmqctl list_connections

Be careful and use at your own risk!

Using a Custom Virtual Host
============================

You can set the name of virtual host by changing the plug-in configuration
file (on debian that is ``/etc/munin/plugin-conf.d``)::

    [rabbitmq-consumers]
    env.vhost vhostname

    [rabbitmq-messages]
    env.vhost vhostname

    [rabbitmq-messages_unacknowledged]
    env.vhost vhostname

    [rabbitmq-messages_uncommitted]
    env.vhost vhostname

    [rabbitmq-queue_memory]
    env.vhost vhostname

Author
======

Ask Solem <askh@opera.com>