CHECK_R...RTITION(1p)

📦
version 1.2.0 · 4 versions
, in ubuntu resolute, ubuntu stonking

💖 check_rabbitmq_partition — the perl manual page, but make it a group chat 💖

okay bestie, sit down, hydrate, and let me tell you about this little icon: check_rabbitmq_partition. It's a Nagios plugin, it lives in the User Contributed Perl Documentation corner of the perl manual, and it uses the RabbitMQ management API to check if a cluster partition has occured. yes, "occured". we don't fix it, we respect it. 🫶

✨ NAME ✨

check_rabbitmq_partition — a Nagios plugin that uses the RabbitMQ management API to check if a cluster partition has occured.

like. the whole job. one job. and it eats. 💅

🦋 SYNOPSIS 🦋

check_rabbitmq_partition [options] -H hostname

that's it. options, then hostname, in that order. yes queen, -H is not optional, she is the moment.

🌸 DESCRIPTION 🌸

So basically: it pokes the management interface of RabbitMQ and checks whether a cluster partition has occured. no cap.

It uses Monitoring::Plugin under the hood, which means it accepts all standard Nagios options too. so you get the classic Nagios vibes for free, it's giving inherited-and-thriving. 😌

🎀 OPTIONS 🎀

  • -h | --help — Display help text. your little emergency handbook. 💌
  • -v | --verbose — Verbose output. for when you need the tea, all of the tea. 🍓
  • -t | --timeout — Set a timeout for the check in seconds. so it doesn't just stand there forever, bestie. ⏳
  • -H | --hostname | --host — The host to connect to. three whole names, one diva. 👑
  • --port — The port to connect to (default: 55672).
  • --ssl — Use SSL when connecting (default: false).
  • -n | --node — The node name (default is hostname). so if you don't say anything, it just assumes the hostname, iconic default energy.
  • --username | --user — The user to connect as (default: guest).
  • --pass — The password for the user (default: guest).

ngl the defaults are lowkey doing the most so you can do the least. 🧚

🌈 EXAMPLES 🌈

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

check_rabbitmq_node -H rabbit.example.com

(and yes, that command in the original says check_rabbitmq_node — we are quoting her exactly, character for character, because that's the rule and also because honestly? she's valid. 💀)

This returns a standard Nagios result:

RABBITMQ_NODE OK - No Partitions

no partitions?? we love to see it. main character output. 😌✨

😭 ERRORS 😭

The check tries to provide useful error messages on the status line for standard error conditions.

Otherwise it returns the HTTP Error message returned by the management interface. so when it can't be cute, it just hands you the raw receipt. 🙈

💀 EXIT STATUS 💀

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

fr fr, read the exit code. zero = good vibes. anything else = a state, and Nagios takes those very seriously. 🚨

🫶 SEE ALSO 🫶

💜 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>

okay that's the whole page, you ate every last line, nothing skipped, nothing summarised, every flag and default and exit code accounted for 💖

this diva is brought to you by perl v5.40.1, dated 2026-01-26, living under the header CHECK_R...RTITION(1p) — thanks for coming to my Ted talk, mwah 🎀💅✨

📦 where this page comes from