munin-rabbitmq/README.rst

=========================
 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 have to tell munin-node to execute them as
root by changing the plug-in configuration file (on debian that is
``/etc/munin/plugin-conf.d``)::

    [rabbitmq_connections]
    user root

    [rabbitmq_consumers]
    user root

    [rabbitmq_messages]
    user root

    [rabbitmq_messages_unacknowledged]
    user root

    [rabbitmq_messages_uncommitted]
    user root

    [rabbitmq_queue_memory]
    user root


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