CHECK_R...Q_QUEUE(1p)

✨ check_rabbitmq_queue(1p) — the manual page, bestie edition ✨

okay so pookies, this is check_rabbitmq_queue, a Perl manpage from the User Contributed Perl Documentation section (1p) 💖 it's a Nagios plugin that uses the RabbitMQ management API to count the messages pending and the consumers on a given queue. Let's get into it 🐰

---

🌸 NAME 🌸

check_rabbitmq_queue — a Nagios plugin that uses the RabbitMQ management API to count the messages pending and the consumers on a given queue 💅

---

🦋 SYNOPSIS 🦋

check_rabbitmq_overview [options] -H hostname

---

💜 DESCRIPTION 💜

So basically bestie, this thingy uses the management interface of RabbitMQ to count:

• the number of pending messages
• the number of ready messages
• the number of unacknowledged messages
• and the number of consumers 🫶

All of those get published as performance metrics for the check, periodt ✨

You can set critical and warning thresholds for each of the metrics — like, every single one, no cap 👑

It uses Monitoring::Plugin and accepts all standard Nagios options, so if you already know Nagios vibes you're already home 💅

---

🎀 OPTIONS 🎀

• -h, --help — shows you the help text 🥺
• -v, --verbose — verbose output, she's chatty 💬
• -t, --timeout — sets a timeout for the check, in seconds ⏱️
• -H, --hostname, --host — the host you're connecting to 🏠
• --port — the port to connect to (default: 55672) 🔌
• --ssl — use SSL when connecting (default: false) 🔒
• --username, --user — the user to connect as (default: guest) 🙋
• --pass — the password for the user (default: guest) 🤫
• -w, --warning — the warning levels for each count of messages, messages_ready, messages_unacknowledged and consumers. This field is made of one to four comma-separated thresholds. Specify -1 if you don't want a threshold for a particular count 🚧
• -c, --critical — the critical levels for each count of messages, messages_ready, messages_unacknowledged and consumers. This field is made of one to four comma-separated thresholds. Specify -1 if you don't want a threshold for a particular count 💀

---

🌈 THRESHOLD FORMAT 🌈

The format of the thresholds you pass in --warning and --critical is defined over here:

<http://nagiosplug.sourceforge.net/developer-guidelines.html#THRESHOLDFORMAT>

For example, to be crtical if more than 100 messages, more than 90 messages_ready, more than 20 messages_unacknowledged or no fewer than 10 consumers, you'd use:

--critical=100,90,20,10:

(yes bestie, the original spells it "crtical" — we're keeping the lore exactly as it is 🙈)

---

💖 EXAMPLES 💖

The defaults all work with a standard fresh install of RabbitMQ, and literally all you need is to specify the host to connect to:

check_rabbitmq_queue -H rabbit.example.com

That returns a standard Nagios result:

RABBITMQ_OVERVIEW OK - messages OK (25794) messages_ready OK (22971)
  messages_unacknowledged OK (2823) consumers OK (10) | messages=25794;;
  messages_ready=22971;; messages_unacknowledged=2823;; consumers=10;;

look at her go 😭 she ate 💅

---

🧚 ERRORS 🧚

The check tries to give you actually useful error messages on the status line for standard error conditions 👍

Otherwise? It returns the HTTP Error message returned by the management interface 🫠

---

⭐ EXIT STATUS ⭐

Returns zero if the check is OK. Otherwise it returns standard Nagios exit codes to signify WARNING, UNKNOWN or CRITICAL state 🚦

---

👑 SEE ALSO 👑

• See Monitoring::Plugin(3)
• The RabbitMQ management plugin is described at <http://www.rabbitmq.com/management.html>

---

🍓 LICENSE 🍓

This file is part of nagios-plugins-rabbitmq.

Copyright 2010, Platform 14.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

---

🫶 AUTHOR 🫶

James Casey <jamesc.000@gmail.com>

---

and that's the whole page, bestie!! 🎀✨ this lil doc came to you courtesy of perl v5.40.1, dated 2026-01-26, and it lives under the alias CHECK_R...Q_QUEUE(1p) — go check your queues, ily, bye 💜🦋