Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

RabbitMQ default checks and policies

Agent Client Collector provides the following default checks and policies for RabbitMQ health monitoring. You must perform RabbitMQ discovery before executing the checks. RabbitMQ checks are available only in a Windows environment.

TypeCheckDescriptionCommand
Eventcheck-rabbitmq-aliveVerifies whether the RabbitMQ server is alive, using the REST API. If the server is down, an alert triggers.`check-rabbitmq-alive.rb --host {{.labels.params_host}} --port {{.labels.params_port}} -v {{.labels.params_vhost}}`
Eventcheck-rabbitmq-cluster-healthVerifies whether the RabbitMQ server's cluster nodes are running. If the nodes are down, an alert triggers.`check-rabbitmq-cluster-health.rb --host {{.labels.params_host}} --port {{.labels.params_port}}`
Eventcheck-rabbitmq-consumersVerifies the number of consumers on the RabbitMQ server and triggers an alert based on the configured threshold.`check-rabbitmq-consumers.rb {{if .labels.params_warn}} --warn {{.labels.params_warn}} {{end}} {{if .labels.params_critical}} --critical {{.labels.params_critical}} {{end}} --host {{.labels.params_host}} --port {{.labels.params_port}}`
Eventcheck-rabbitmq-messagesVerifies the total number of messages queued on the RabbitMQ server and triggers an alert based on the threshold.`check-rabbitmq-messages.rb --critical {{.labels.params_critical}} --port {{.labels.params_port}} --warn {{.labels.params_warn}} --host {{.labels.params_host}}`
Eventcheck-rabbitmq-network-partitionsVerifies whether the RabbitMQ network partition has occurred and triggers an alert based on the threshold.check-rabbitmq-network-partitions.rb --host \{\{.labels.params\_host\}\} --port \{\{.labels.params\_port\}\}
Eventcheck-rabbitmq-node-healthVerifies whether the RabbitMQ server node is in a running state.
check-rabbitmq-node-health.rb --host {{.labels.params_host}} {{if .labels.params_watchalarms}} --alarms {{.labels.params_watchalarms}} {{end}} {{if .labels.params_socketwarn}} --swarn {{.labels.params_socketwarn}} {{end}} {{if .labels.params_memcrit}} --mcrit {{.labels.params_memcrit}} {{end}} {{if .labels.params_fdcrit}} --fcrit {{.labels.params_fdcrit}} {{end}} {{if .labels.params_socketcrit}} --scrit {{.labels.params_socketcrit}} {{end}} --port {{.labels.params_port}} {{if .labels.params_memwarn}} --mwarn {{.labels.params_memwarn}} {{end}} {{if .labels.params_fdwarn}} --fwarn {{.labels.params_fdwarn}} {{end}}
Eventcheck-rabbitmq-node-usageChecks and displays usage of the RabbitMQ server node.
check-rabbitmq-node-usage.rb {{if .labels.params_procwarn}} --pwarn {{.labels.params_procwarn}} {{end}} --port {{.labels.params_port}} {{if .labels.params_socketwarn}} --swarn {{.labels.params_socketwarn}} {{end}} --type {{.labels.params_type}} {{if .labels.params_diskcrit}} --dcrit {{.labels.params_diskcrit}} {{end}} {{if .labels.params_fdcrit}} --fcrit {{.labels.params_fdcrit}} {{end}} {{if .labels.params_proccrit}} --pcrit {{.labels.params_proccrit}} {{end}} {{if .labels.params_diskwarn}} --dwarn {{.labels.params_diskwarn}} {{end}} {{if .labels.params_socketcrit}} --scrit {{.labels.params_socketcrit}} {{end}} --host {{.labels.params_host}} {{if .labels.params_memcrit}} --mcrit {{.labels.params_memcrit}} {{end}} {{if .labels.params_fdwarn}} --fwarn {{.labels.params_fdwarn}} {{end}} {{if .labels.params_memwarn}} mwarn {{.labels.params_memwarn}} {{end}}
Eventcheck-rabbitmq-queue-drain-timeVerifies the time it will take for each queue on the RabbitMQ server to drain, based on the current message exit rate.For example, if a queue has 1,000 messages in it but only 1 message exits per second, an alert generates because the default critical level of 360 seconds has been exceeded.`check-rabbitmq-queue-drain-time.rb --host {{.labels.params_host}} --port {{.labels.params_port}} --warn {{.labels.params_warn}} --critical {{.labels.params_critical}}`
Eventcheck-rabbitmq-queues-synchronisedVerifies that all mirrored queues with secondary queues are synchronised.`check-rabbitmq-queues-synchronised.rb --host {{.labels.params_host}} --port {{.labels.params_port}}`
Eventcheck-rabbitmq-stomp-aliveVerifies whether the RabbitMQ server is alive and responding to STOMP.`check-rabbitmq-stomp-alive.rb --host {{.labels.params_host}} --queue {{.labels.params_queue}} --port {{.labels.params_port}}`
TypeCheckDescriptionCommand
Metricmetrics-rabbitmq-overviewProvides RabbitMQ overview statistics.metrics-rabbitmq-overview.rb --port {{.labels.params_port}} --host {{.labels.params_host}}
Metricmetrics-rabbitmq-queueProvides RabbitMQ metrics per queue.metrics-rabbitmq-queue.rb --port {{.labels.params_port}} --host {{.labels.params_host}} {{if .labels.params_vhost}} --vhost {{.labels.params_vhost}} {{end}}

Parent Topic:Agent Client Collector Monitoring default checks and policies