rabbitmq-diagnostics
Diagnose RabbitMQ node and cluster health
TLDR
Check node health
$ rabbitmq-diagnostics check_running
Check cluster status$ rabbitmq-diagnostics cluster_status
Check alarms$ rabbitmq-diagnostics check_alarms
Memory breakdown$ rabbitmq-diagnostics memory_breakdown
Check virtual hosts$ rabbitmq-diagnostics check_virtual_hosts
SYNOPSIS
rabbitmq-diagnostics [options] command [commandoptions_]
DESCRIPTION
rabbitmq-diagnostics provides health checks and diagnostic information for RabbitMQ nodes and clusters. It's the primary tool for monitoring RabbitMQ health.
PARAMETERS
-n node
Target node.-t timeout
Command timeout.--formatter format
Output format (json, csv).-q
Quiet mode.
EXAMPLES
$ # Node health check
rabbitmq-diagnostics check_running
# Cluster status
rabbitmq-diagnostics cluster_status
# Check for alarms
rabbitmq-diagnostics check_alarms
# Memory usage
rabbitmq-diagnostics memory_breakdown
# Check port listeners
rabbitmq-diagnostics check_port_connectivity
# JSON output
rabbitmq-diagnostics status --formatter json
rabbitmq-diagnostics check_running
# Cluster status
rabbitmq-diagnostics cluster_status
# Check for alarms
rabbitmq-diagnostics check_alarms
# Memory usage
rabbitmq-diagnostics memory_breakdown
# Check port listeners
rabbitmq-diagnostics check_port_connectivity
# JSON output
rabbitmq-diagnostics status --formatter json
HEALTH CHECKS
$ check_running # Node is running
check_alarms # No resource alarms
check_local_alarms # No local alarms
check_port_connectivity # Ports accessible
check_virtual_hosts # VHosts operational
check_alarms # No resource alarms
check_local_alarms # No local alarms
check_port_connectivity # Ports accessible
check_virtual_hosts # VHosts operational
CAVEATS
Requires running RabbitMQ node. Some commands need appropriate permissions. Part of RabbitMQ server package.
HISTORY
rabbitmq-diagnostics was introduced in RabbitMQ 3.8 as a dedicated diagnostics tool, replacing some rabbitmqctl functions.
SEE ALSO
rabbitmqctl(8), rabbitmq-plugins(8), rabbitmq-server(8)