SHOWGRAPH.CGI(1)

💖 SHOWGRAPH.CGI(1) 💖

okay bestie, pull up a chair, because today we're learning about showgraph.cgi — a whole CGI script whose entire job is making Xymon trend graphs pop off. it lives in section 1 of the manual (you know, the general commands manual) and honestly? she's iconic. ✨

✨ SYNOPSIS ✨

showgraph [options]

🌸 DESCRIPTION 🌸

so the tea is: showgraph.cgi doesn't just walk in the front door, no ma'am. she gets invoked as a CGI script through the showgraph.sh CGI wrapper. that's the whole entrance situation. 🎀

and how does she know what you want? she gets handed a QUERY_STRING environment variable stuffed with the following parameters, and she reads them like a group chat she's been waiting all day to reply to:

• host — the name of the host you want a graph for. like, whose graph are we making, babe?
• service — the name of the service you want a graph for.
• disp — the display-name of the host. this is what actually shows up on the generated graphs instead of the hostname. cute nickname energy, lowkey.
• graph — can be "hourly", "daily", "weekly" or "monthly", and it picks the time period the graph covers. choose your era. ⏰
• first — used to split multi-graphs into multiple graphs. this makes showgraph.cgi generate only the graphs starting with the "first"th graph and continuing for "count". yes, the original really does put "first" and "count" in quotes like that, we respect the lore. 📚
• count — the number of graphs in a multi-graph. how many are we serving today.
• upper — sets the upper limit of the graph. peep rrdgraph(1) for the description of the -u option.
• lower — sets the lower limit of the graph. peep rrdgraph(1) for the description of the -l option.
• graph_start — sets the starttime of the graph. this one is used in zoom-mode. 🔍
• graph_end — sets the end-time of the graph. also zoom-mode coded.
• action=menu — generates an HTML page with links to 4 graphs, representing the hourly, weekly, monthly and yearly graphs. and get this — it doesn't actually generate any graphs at all, just the HTML that links to them. she's a connector, not a maker. 💅
• action=selzoom — generates an HTML page with a link to a single graph, plus JavaScript code that lets the user select part of the graph for a zoom-operation. the JavaScript then invokes showgraph.cgi with "action=showzoom" to generate the zoomed graph webpage. nesting dolls but make it graphs.
• action=showzoom — generates HTML with a link to the zoomed graph image. that link goes to an "action=view" invocation of showgraph.cgi.
• action=view — generates a single graph image. that's it, that's the one. ✨

👑 OPTIONS 👑

• --config=FILENAME — loads the graph configuration file from FILENAME. if you don't specify one, the file $XYMONHOME/etc/graphs.cfg gets used instead. wanna know all about that file? check graphs.cfg(5), it spills everything. 📄
• --env=FILENAME — loads the environment settings defined in FILENAME before executing the CGI. get dressed before you go out, basically. 🧚
• --rrddir=DIRECTORY — the top-level directory for the RRD files. if you don't specify it, the directory given by the XYMONRRDS environment gets used. home is wherever the RRDs are. 🏠
• --save=FILENAME — instead of returning the image via the CGI interface (i.e. on stdout), it saves the generated image to FILENAME. no stage fright, just file it away. 💾
• --debug — enable debugging output. turn the mic on, bestie. 🎤

🌈 ENVIRONMENT 🌈

• QUERY_STRING — provided by the webserver CGI interface, this is the thing that decides what graph gets generated. she's the main character of the env vars, no cap. 👑
• RRDGRAPHOPTS — RRD-specific options for the graph. this is usually set in the xymonserver.cfg(5) file.

🦋 FILES 🦋

• graphs.cfg — the configuration file determining how graphs are generated from RRD files. the blueprint, the vision board, the whole plan. 📋

⭐ SEE ALSO ⭐

• graphs.cfg(5)
• xymon(7)
• rrdtool(1)

and that's the whole page, bestie — go forth and graph. this was Xymon, Version 4.3.30: 4 Sep 2019, and honestly? she ate. periodt. 💖✨🫶