ganeti-mond(8)

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

👑 ganeti-mond — the Ganeti monitoring daemon

okay bestie, sit down, hydrate, and let me tell you about ganeti-mond(8) from the Ganeti gang, version 3.1.0~rc2. she's the monitoring daemon and she's literally carrying the whole observability situation on her back 💅

✨ SYNOPSIS ✨

ganeti-mond [-f] [-d] [-p PORT] [-b ADDRESS] [--no-user-checks]

🌸 DESCRIPTION 🌸

so ganeti-mond is the daemon that does the Ganeti monitoring thing. her whole job? running the data collectors and then serving up all that collected info through an HTTP interface. she's the main character and the backend at the same time, iconic honestly 👑

for testing purposes, you can pass the -f option and the program will not detach from the running terminal. she stays right there with you. clingy in a cute way 🫶

want debug-level messages? activate them by giving the -d option. it's giving "tell me everything" energy.

by default the ganeti-mond daemon listens to port 1815 TCP, on all interfaces. the port can be overridden by an entry in the services database, and you do that by passing the -p option. then there's the -b option, which specifies the address to bind to (defaults to 0.0.0.0). and listen — the daemon will refuse to start if the user and group do not match the one defined at build time. that's a hard no from her, no cap. this behaviour can be overridden by the --no-user-checks option, if you're feeling spicy 🌶️

💖 COMMUNICATION PROTOCOL 💖

the queries to the monitoring agent will be HTTP GET requests on port 1815. the answer comes back encoded in JSON format and depends on the specific accessed resource, iykyk.

if a request is sent to a non-existing resource, a 404 error will be returned by the HTTP server. she said "not found, not today" 💀

🎀 /

the root resource. it will return the list of the supported protocol version numbers. like a little hello wave from the server 👋

🎀 /1/list/collectors

returns a list of tuples (kind, category, name) showing all the collectors available in the system. the whole roster, exposed ✨

🎀 /1/report/all

a list of the reports of all the data collectors.

status reporting collectors will provide their output in non-verbose format. the verbose format can be requested by adding the parameter verbose=1 to the request. yes bestie, you can just ask for more 👀

🎀 /1/report/[category]/[collector_name]

returns the report of the collector [collector_name] that belongs to the specified [category].

if a collector does not belong to any category, collector will be used as the value for [category]. good to know, fr fr.

status reporting collectors will provide their output in non-verbose format. the verbose format can be requested by adding the parameter verbose=1 to the request. same deal as above, she's consistent 💅

further information can be found in the Ganeti Monitoring Agent design document. go read it, it's right there 🦋

😭 REPORTING BUGS 😭

report bugs to the project's issue tracker or contact the developers using the Ganeti mailing list. please be nice, they're doing their best 🫶

🌈 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 💖 she's part of the Ganeti crew, she answers to the name ganeti-mond(8), and this whole thing is from Version 3.1.0~rc2. go run her, she's so good at her job, periodt 🎀✨🦋

📦 where this page comes from