CRITICALVIEW.CGI(1)

📦 version 4.3.30, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 CRITICALVIEW.CGI 💖

okay bestie, so this is the manual page for criticalview.cgi — it lives in section 1 of the General Commands Manual and honestly? she's a little legend. sit down, grab a strawberry, let's get into it 🍓✨

✨ NAME ✨

criticalview.cgi — the Xymon Critical Systems view CGI. that's her. that's the whole vibe. 👑

🌸 SYNOPSIS 🌸

criticalview.cgi

no args, no drama, she just is. periodt.

🦋 DESCRIPTION 🦋

so criticalview.cgi gets invoked as a CGI script — and like, through the criticalview.sh CGI wrapper, okay? that's the whole entrance, the red carpet moment. 💅

what she does: she takes all the current critical statuses and matches them up against the critical.cfg(5) file. then she generates the "Critical Systems" view. that's it. that's the job. no cap.

🌈 RELATION TO OLD CRITICAL PAGE 🌈

okay this is the glow-up section. this view is a replacement for the statically generated "critical" page that shipped in versions of Xymon prior to version 4.2. so old money, basically.

and yeah, the "critical" pages are still supported all the way through Xymon 4.x — no one's coming for them — but the recommendation is that You (capital-Y You, bestie) switch over to the newer Critical Systems view that this CGI gives you. it's giving upgrade era. 🫶

💅 OPTIONS 💅

  • --acklevel=NUMBER — sets the acknowledgment level for acknowledgments that get sent through the ackinfo.cgi(1) page. heads up tho: this can be overridden by the configuration of the ackinfo.cgi utility. so she says one thing, the config might say another. 😭
  • --tooltips — hides the host description inside a "tooltip", which means it only pops up when your mouse hovers over the hostname on the webpage. super lowkey. and the reason it slaps? it saves space on the display so there's way more room for the status columns. main character energy, minimal footprint. ✨
  • --hffile=PREFIX — defines the header/footer files used when building the webpage. the actual files it uses will be PREFIX_header and PREFIX_footer, and they live in the ~xymon/server/web/ directory. Default: critical.
  • --env=FILENAME — loads the environment defined in FILENAME before executing the CGI script. pre-game ritual, basically. 🌸
  • --area=NAME — loads environment variables for a specific area. NB: if you use this one, it must appear before any --env=FILENAME option. order matters, bestie, don't play yourself. 🙈
  • --debug — enables debugging output. she starts telling you everything. 🐛
  • --config=FILENAME — use FILENAME as the configuration file for the Critical Systems information. the default is to load this from $XYMONHOME/etc/critical.cfg.
  • --config=ID:FILENAME — allows the use of multiple Critical Systems configuration files on a single webpage. "ID" is a text that will be shown on the web page prior to the critical systems from FILENAME. and the fun part: this option can be repeated to include critical systems from multiple configurations. stacking them like bracelets. 🎀

🧚 ENVIRONMENT VARIABLES 🧚

  • XYMONHOME — used to locate the template files for the generated web pages. she needs to know where home is. relatable.
  • QUERY_STRING — contains the parameters for the CGI script. the receipts, basically. 💜

👑 SEE ALSO 👑

ackinfo.cgi(1), xymon(7)

okay that's the whole page, go forth and be critical (systems view). 🔥

signed, sealed, delivered: this page is brought to you by Xymon, Version 4.3.30, dated 4 Sep 2019 — mwah, love that for us 💖💫

📦 where this page comes from