RabbitMQ plugin

RabbitMQ is an open source, complete and highly reliable enterprise messaging system based on the AMQP standard. For more information visit rabbitmq.com.

Discovery

Even if the RabbitMQ plugin is not configured, Monitoring will discover RabbitMQ services running in your Cloud Platform project by:

• searching instance names for rabbit or rabbitmq
• checking for ports opened to 5672 via firewall rules

The services discovered are displayed on the RabbitMQ Services page in the Resources menu. After you install the monitoring agent and configure the RabbitMQ plugin on your instances, Monitoring populates the RabbitMQ Services page with inventory and metrics.

Configuring Monitoring to monitor RabbitMQ

After you install the monitoring agent, use the following instructions to configure the RabbitMQ plugin on your instances.

Prerequisites

The RabbitMQ plugin requires version 5.5.0-315 or later of the monitoring agent. To update the agent, see Upgrading the agent.

Enabling the RabbitMQ monitoring plugin

RabbitMQ is configured per queue on your system. At the moment, no drop-in configuration is available. The following configuration file shows how to configure one queue, named QUEUE_NAME.

On your VM instance, download rabbitmq.conf from the GitHub configuration repository and place it in the directory /opt/stackdriver/collectd/etc/collectd.d/:

(cd /opt/stackdriver/collectd/etc/collectd.d/ && curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/rabbitmq.conf)

Edit the downloaded configuration file and add information about your queues. Inline comments point out where you need to add configuration for additional queues. Wherever you see QUEUE_NAME, substitute the name of your queue.

After editing the configuration file, restart the monitoring agent by running the following command:

sudo service stackdriver-agent restart

Information on other plugin configuration options can be found at collectd.org.

What is monitored

The RabbitMQ plugin monitors the following metrics:

• Messages (count): Sum of ready and unacknowledged messages (queue depth).
• Messages Ready (count): Number of messages ready to be delivered to clients.
• Messages Unacknowledged (count): Number of messages delivered to clients but not yet acknowledged.
• Consumers (count): Number of consumers reading messages from the queue.
• Publish Rate (count/s): How many messages are being published by the broker per second.
• Deliver Rate (count/s): How many messages are being delivered to the consumer per second.

For details, see Agent metrics list: RabbitMQ.