Overview

This check uses the management API to check if mem_alarm or disk_free_alarm has been triggered. If one of those alarms has been triggered the rabbitmq node will block (for more information: https://www.rabbitmq.com/memory.html).

This value should always be zero, if this is not zero rabbitmq blocked messages.

Basic Troubleshooting

Rabbitmq highly relies on ram/hdd quotas, so if You'are reading it probably there is problem with one of them.

As first point please refer to logfile under

/var/log/rabbitmq/rabbit@suapq501.log (hostname can change)

2021-12-22 09:03:31.323 [info] <0.330.0> Free disk space is sufficient. Free bytes: 30009249792. Limit: 30000000000                                                                                                                 [114/1918]
2021-12-22 09:03:31.323 [warning] <0.320.0> disk resource limit alarm cleared on node rabbit@suapq501
2021-12-22 09:03:31.323 [warning] <0.320.0> disk resource limit alarm cleared across the cluster
2021-12-22 09:03:33.929 [info] <0.330.0> Free disk space is insufficient. Free bytes: 29999316992. Limit: 30000000000
2021-12-22 09:03:33.929 [warning] <0.320.0> disk resource limit alarm set on node rabbit@suapq501.
                                                                                                                       
**********************************************************                                                             
*** Publishers will be blocked until this alarm clears ***

Technical Details

Implementation

Global base check	No
Puppet profiles using this check	profile_rabbitmq

Check plugins

Name	check_rabbitmq_watermark
Packages	nagios-plugins-rabbitmq-vshn
CheckCommand name	rabbitmq_watermark
Upstream source link	https://git.vshn.net/vshn/nagios-plugins-rabbitmq-vshn
Documentation link	https://git.vshn.net/vshn/nagios-plugins-rabbitmq-vshn/blob/master/check_rabbitmq_watermark

List of variables

Icinga2 variable	Default Value	Description
rabbitmq_host	(not set) / required	The hostname to connect to
rabbitmq_username	monitoring	The user to connect as
rabbitmq_password	fqdn_rand_string(20)	The password for the user
rabbitmq_management_port	15672	The management API port to connect to
rabbitmq_ssl	false	Comma separated list of expected nodes in the cluster
rabbitmq_nodename	$rabbitmq_host	The nodename to use for monitoring

Customer Knowledge Base