mon-collector(7)

📦
version 3.1.0~rc2 · 4 versions
, in debian trixie, ubuntu questing, ubuntu resolute

🌸 NAME 🌸

mon-collector — the command line interface for the data collectors of the monitoring system. That's the whole vibe, bestie: it's the manual page for mon-collector(7), and it's about to be your new fave. 💖

✨ SYNOPSIS ✨

mon-collector {collector}

💅 DESCRIPTION 💅

Okay so mon-collector is literally a whole suite of tools, and its entire job is to give you a command line interface to the data collectors that the ganeti monitoring system implements. Iconic behavior honestly.

mon-collector is also the generic binary — like, the main character — and the way you use it is by invoking it and passing, as the very first command line parameter, the name of the actual data collector you want it to run. That's it, that's the ritual. 🫶

When it runs, mon-collector will execute the collector you picked and print its output to stdout, in JSON format. Clean. Serialized. Slay. ✨

👑 COLLECTORS 👑

🍓 DISKSTATS 🍓

diskstats [ [ -f | --file ] = input-file ]

This one collects all the info about the status of the disks of your system, exactly as they're listed by /proc/diskstats — or from an alternate file with the same syntax if you point it at one on the command line. 🧚

The options that can be passed to the DRBD collector are as follows:

ngl yes, it says DRBD right there in the DISKSTATS section. we don't make the rules, we just report them fr fr 💀
  • -f input-file, --file=input-file — where to read the data from. Default if not specified: /proc/diskstats

🌈 DRBD 🌈

drbd [ [ -s | --drbd-status ] = status-file ] [ [ -p | --drbd-pairing] = pairing-file ]

Collects the info about the version and status of the DRBD kernel module, plus the status of the disks it's managing. Main character energy for your kernel module, honestly. 💜

If status-file and pairing-file are specified, then the status and the instance-minor pairing information get read from those files. Otherwise? The collector reads them, respectively, from /proc/drbd and from the Confd server. No files, no problem.

The options that can be passed to the DRBD collector are as follows:

  • -s status-file, --drbd-status=status-file — read the DRBD status from the specified file instead of /proc/drbd
  • -p pairing-file, --drbd-pairing=pairing-file — read the information about the pairing between instances and DRBD minors from the specified file, instead of asking the Confd servers for them

🦋 INSTANCE STATUS 🦋

inst-status-xen [ [ -a | --address ] = ip-address ] [ [ -p | --port ] = port-number ]

Collects the info about the status of the instances of the current node. To pull this off it needs to connect to the ConfD daemon and fetch some configuration information. The following parameters let you specify the position where the daemon is listening, in case it's not the default one — because sometimes your daemon is just vibing somewhere else. 🙈

  • -a ip-address, --address=ip-address — the IP address the ConfD daemon is listening on
  • -p port-number, --port=port-number — the port the ConfD daemon is listening on

💖 LOGICAL VOLUMES 💖

lv [ [ -a | --address ] = ip-address ] [ [ -p | --port ] = port-number ] [ [ -f | --file ] = input-file ] [ [ -i | --instances ] = instances-file ]

Collects the info about the logical volumes of the current node. 🎀

To do this, it needs to interact with the lvs command line tool and connect to the ConfD daemon to fetch some configuration information. The following parameters let you specify the position where the daemon is listening, in case it's not the default one:

  • -a ip-address, --address=ip-address — the IP address the ConfD daemon is listening on
  • -p port-number, --port=port-number — the port the ConfD daemon is listening on

Instead of accessing the live data on the cluster, the tool can also read data serialized on files (mainly for testing purposes, iykyk). Namely:

  • -f input-file, --file input-file — the name of the file containing a recorded output of the lvs tool
  • -i instances-file, --instances=instances-file — the name of the file containing a JSON serialization of instances the current node is primary and secondary for, listed as:
([Instance], [Instance])

where the first list contains the instances the node is primary for, and the second list contains those the node is secondary for. Two lists, two moods. 🫶

😭 REPORTING BUGS 😭

Found a bug? Report it to the project's issue tracker, or contact the developers using the Ganeti mailing list. They wanna hear from you, fr fr. 💌

⭐ SEE ALSO ⭐

Ganeti overview and specifications:

Ganeti commands:

Ganeti daemons:

Ganeti htools:

Copyright (C) 2006-2015 Google Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

And that's the whole page, bestie. 🎀 This little love letter to mon-collector(7) comes to you from the Ganeti source, Version 3.1.0~rc2. Go collect some data, you absolute icon. 💅✨

📦 where this page comes from