SIMPLEMONITOR(1)

📦 version 1.15.0, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SIMPLEMONITOR(1) — the group-chat guide 💖

okay bestie, so this is simplemonitor, section 1 of the General Commands Manual. yes, the whole entire manual page for the simplemonitor executable. pull up a chair, grab a boba, we're doing this 🧋✨

✨ NAME ✨

simplemonitor — monitor hosts status and network connectivity

🌸 SYNOPSIS 🌸

simplemonitor [OPTIONS]

that's it. that's the whole vibe. no subcommands, no drama, just options. periodt 💅

🦋 DESCRIPTION 🦋

okay so simplemonitor does two big things and it does them well:

  • it monitors hosts — like disk space, load average, services, HTTP availability and much more
  • it monitors network connectivity — based on ping replies 👑

and no, this page is not the whole story, bestie. this manual page is for the simplemonitor executable options only. the full documentation for how to add monitors and alerters lives at:

/usr/share/doc/simplemonitor/html

go there for the deep lore 📚

👑 OPTIONS 👑

here's the main menu, no cap:

  • -h, --help — show help and exit. iconic. the classic.
  • -p PIDFILE, --pidfile PIDFILE — write the PID into PIDFILE. put your process ID somewhere cute.
  • -N, --no-network — disable the network listening socket (that's only if it's enabled in your config, iykyk).
  • -f CONFIG, --config CONFIG — the configuration file. this is the main config. and heads up: monitors.ini is also needed (that's the default filename). yes, two files. it's giving main character and supporting cast 💀

🌈 OUTPUT CONTROLS 🌈

the "how loud do you want your logs" section:

  • -v, --verbose — alias for --log-level=info. chatty era.
  • -q, --quiet — alias for --log-level=critical. silent era. 🤫
  • -d, --debug — alias for --log-level=debug. we're snooping now 🔍
  • -l LOGLEVEL, --log-level LOGLEVEL — set the log level. your choices are: critical, error, warn, info, debug.
  • -C, --no-colour, --no-color — do not colourise the log output. (yes there are two spellings, we love an inclusive king 🌍)
  • --no-timestamps — do not prefix log output with timestamps. rawdogging the logs fr fr.

🎀 TEST AND DEBUG TOOLS 🎀

the "let me check this real quick" section:

  • -t, --test — test the config and exit. a little vibe check for your config ✨
  • -l, --one-shot — run the monitors once only, without alerting. it requires monitors without "fail" in the name to succeed, and it exits zero or non-zero accordingly.
🚨 okay pause, bestie — yes, -l shows up twice on this page, once for --log-level and once for --one-shot. that's literally what the original says, so i'm not touching it. i'm just reporting the news 💅
  • --loops LOOPS — number of iterations to run before exiting.
  • --dump-known-resources — print out the loaded Monitor, Alerter and Logger types. a full inventory moment 📋

💜 AUTHOR 💜

this manual page was written by Carles Pina i Estany <carles@pina.cat> for the Debian system (but may be used by others). permission is granted to copy, distribute and/or modify this document under the terms of the BSD-3-clause. slay, thank you Carles 🫶

💖 SEE ALSO 💖

full documentation in:

/usr/share/doc/simplemonitor/html

and that's the whole page, bestie!! 🎉 SIMPLEMONITOR(1) from the General Commands Manual, signed, sealed, delivered, and yes — the footer says SIMPLEMONITOR(1) too, so we're bookending this thing like a true icon 👑💅 go monitor something, you've got this 🌸✨

📦 where this page comes from