CHECK_..._SERVER(1p)

💖 CHECK_..._SERVER(1p) 💖

okay bestie, welcome to check_rabbitmq_server — a 1p manual page from the User Contributed Perl Documentation corner of the universe, and no cap, she's a whole vibe. sit down, grab a lil snack, we're gonna go through her together 🫶

---

✨ NAME ✨

check_rabbitmq_server — it's a Nagios plugin that slides into the RabbitMQ management API to check how your server resources are doing: processes, memory, file descriptors, and sock descriptors. she's nosy but, like, in a helpful way 💅

---

🌸 SYNOPSIS 🌸

check_rabbitmq_server [options] -H hostname

literally that's it. -H your host and go. main character energy.

---

🦋 DESCRIPTION 🦋

bestie, so here's the tea ☕ — she uses the management interface of RabbitMQ to check the resource usage of the server. she peeks at the node statistics for the rabbit node on the host and examines the erlang memory, process, and file descriptor usage. investigative journalist behavior, honestly.

she provides performance data for each of these variables, and she lets you specify warning and criticality levels for each one. so you're not just getting a vibe check, you're getting numbers 🌈

and she uses Monitoring::Plugin, which means she accepts all the standard Nagios options. she plays nice with the whole friend group 😌

---

🎀 OPTIONS 🎀

• -h | --help — displays the help text. your lil bestie explaining herself 💖
• -v | --verbose — verbose output. she will yap (affectionately).
• -t | --timeout — sets a timeout for the check, in seconds.
• -H | --hostname | --host — the host to connect to. the one you gotta have, fr fr.
• --port — the port to connect to. default: 55672.
• --ssl — use SSL when connecting. default: false.
• -w | --warning — the warning levels, expressed as a percentage for each of memory, process, file descriptor and sockets usage. this field is four comma-separated integers. default: 80,80,80,80.
• -c | --critical — the critical levels, expressed as a percentage for each of memory, process, file descriptor and sockets usage. this field is four comma-separated integers. default: 90,90,90,90.
• -n | --node — the node name. default is the hostname.
• --username | --user — the user to connect as. default: guest.
• --pass — the password for the user. default: guest.

🚨 friendly reminder that -w and -c want four numbers, in that exact order: memory, process, file descriptor, sockets. don't be out here sending three, she WILL notice.

---

🌟 EXAMPLES 🌟

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

check_rabbitmq_server -H rabbit.example.com

and she returns a standard Nagios result, slay:

RABBITMQ_SERVER OK - Memory OK (6.19%) Process OK (0.01%)
    FD OK (2.53%) Sockets OK (0.86%) | Memory=6.19%;80;90 Process=0.01%;80;90 FD=2.53%;80;90 Sockets=0.86%;1;2

okay now the fun part — you can specify different warning and criticality levels. -w and -c both accept four comma-separated percentages, which represent the thresholds for memory, process and file descriptor usage respectively. for example, to specify warnings for memory at 60%, process at 80%, file descriptors at 95%, and socket descriptors at 90%:

check_rabbitmq_server -H rabbit.example.com  -w 60,80,95,90

periodt. custom thresholds, custom life 💅

---

🙈 ERRORS 🙈

the check tries to provide useful error messages on the status line for standard error conditions. she's communicative, she's emotionally available.

otherwise, she returns the HTTP Error message returned by the management interface. so if things go sideways, it's the management interface telling on itself, not her fault 🌸

---

💀 EXIT STATUS 💀

returns zero if the check is OK. otherwise she returns standard Nagios exit codes to signify WARNING, UNKNOWN or CRITICAL state. classic Nagios behavior, no notes.

---

⭐ SEE ALSO ⭐

see Monitoring::Plugin(3) — the queen she's built on 👑

the RabbitMQ management plugin is described at http://www.rabbitmq.com/management.html — go read it, iykyk.

---

👑 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.

like, legal stuff but make it fancy ✨

---

🧚 AUTHOR 🧚

James Casey <jamesc.000@gmail.com> 💜

---

and that's the whole page, bestie!! she runs on perl v5.40.1 and this version is dated 2026-01-26 — so yeah, she's fresh, she's formatted, she's CHECK_..._SERVER(1p) and she ate. go check those servers, you got this 🫶🌸💖