HOSTGRAPHS.CGI(1)

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

✨ HOSTGRAPHS.CGI(1) — the hostgraphs.cgi glow-up ✨

General Commands Manual 💅 bestie, pull up a chair, we're looking at the CGI script that shows you multiple graphs at once.

🌸 NAME 🌸

hostgraphs.cgi — a CGI program that shows you a whole bunch of graphs, like a little gallery but make it monitoring 📊✨

🎀 SYNOPSIS 🎀

hostgraph.cgi

(yeah that's it, she's low maintenance)

🦋 DESCRIPTION 🦋

okay so. hostgraph.cgi gets invoked as a CGI script, and it gets there via the hostgraph.sh CGI wrapper. that's the whole entrance situation. 🚪✨

If you invoke it with no parameters at all? She serves you a form. A cute little form where you pick a time period, one or more hosts, and a set of graphs. Very choose-your-own-adventure, very main character energy. 🫶

Then all those parameters you picked get passed to a second invocation of hostgraph.cgi, and that one gives you a webpage with a list of graph images, built from the trend data stored about the hosts. it's giving glow-up, honestly. 🔥

If you select multiple graph-types, hostgraph.cgi shows you a list of graphs — one graph per type. Simple. Clean. Iconic. 👑

If you select multiple hosts, hostgraph.cgi will try to show a multi-host graph for each type, where all the hosts' graphs get overlayed into a single image. so you can compare them side by side without playing spot-the-difference. it's the comparison arc we deserve 💖

Now, the hostlist: it uses the PAGEPATH cookie that Xymon webpages provide, to figure out which hosts to present. Only the hosts visible on the page where hostgraph.cgi is invoked from will be visible. no sneaky peeking at hosts that aren't on that page, periodt. 🚫👀

And bestie, listen — the resulting graph page can be bookmarked! cute! but ⚠️ the bookmark also fixates the time period shown. so your bookmark is a lil time capsule. it will always show that period. not a bug, just the vibe. 🕰️

💖 OPTIONS 💖

  • --env=FILENAME — loads the environment defined in FILENAME before executing the CGI script. basically a pre-game warmup for your env vars 🌈

💀 BUGS 💀

ngl, some stuff here is a little unhinged:

  • This utility is experimental. It may change in a future release of Xymon. so don't get too attached, she's still figuring herself out 😭
  • It is possible for the user to select graphs which do not exist. This results in broken image links. yeah. you'll get the little sad broken-image icon. we've all been there 🙈
  • The set of graph-types is fixed in the server/web/hostgraphs_form template and does not adjust to which graphs are actually available. so the menu is the menu, whether the graphs show up or not. she does not read the room 💀
  • If the tool is invoked directly, all hosts defined in Xymon will be listed. every single one. no filtering, no chill. 🔥

👑 SEE ALSO 👑

hosts.cfg(5), xymonserver.cfg(5) — go read your besties too 🫶

okay that's the whole page!! mwah 💋 this manual page came to you from Xymon, Version 4.3.30, dated 4 Sep 2019 — an absolute vintage, we love a classic, slay ✨🎀🦋

📦 where this page comes from