RabbitMQ is an open source, complete and highly reliable enterprise messaging system based on the AMQP standard. For more information visit rabbitmq.com.
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.
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
(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.