NAME

       showgraph.cgi - CGI to generate Xymon trend graphs

SYNOPSIS

       showgraph [options]

DESCRIPTION

       showgraph.cgi is invoked as a CGI script via the showgraph.sh CGI wrapper.

       showgraph.cgi is passed a QUERY_STRING environment variable with the following parameters:

       host Name of the host to generate a graph for

       service Name of the service to generate a graph for

       disp Display-name of the host, used on the generated graphs instead of hostname.

       graph Can be "hourly", "daily", "weekly" or "monthly" to select the time period that the graph covers.

       first  Used  to  split  multi-graphs into multiple graphs. This causes showgraph.cgi to generate only the
       graphs starting with the "first'th" graph and continuing for "count".

       count Number of graphs in a multi-graph.

       upper Set the upper limit of the graph. See rrdgraph(1) for a description of the "-u" option.

       lower Set the lower limit of the graph. See rrdgraph(1) for a description of the "-l" option.

       graph_start Set the starttime of the graph. This is used in zoom-mode.

       graph_end Set the end-time of the graph. This is used in zoom-mode.

       action=menu Generate an HTML page with links to 4 graphs, representing the hourly,  weekly,  monthly  and
       yearly graphs. Doesn't actually generate any graphs, only the HTML that links to the graphs.

       action=selzoom  Generate  an  HTML page with link to single graph, and with JavaScript code that lets the
       user select  part  of  the  graph  for  a  zoom-operation.  The  JavaScript  invokes  showgraph.cgi  with
       "action=showzoom" to generate the zoomed graph webpage.

       action=showzoom  Generate  HTML with a link to the zoomed graph image. This link goes to an "action=view"
       invocation of showgraph.cgi.

       action=view Generate a single graph image.

OPTIONS

       --config=FILENAME
              Loads   the   graph   configuration   file   from   FILENAME.   If   not   specified,   the   file
              $XYMONHOME/etc/graphs.cfg is used. See the graphs.cfg(5) for details about this file.

       --env=FILENAME
              Loads the environment settings defined in FILENAME before executing the CGI.

       --rrddir=DIRECTORY
              The  top-level directory for the RRD files. If not specified, the directory given by the XYMONRRDS
              environment is used.

       --save=FILENAME
              Instead of returning the image via the CGI interface (i.e. on stdout), save the generated image to
              FILENAME.

       --debug
              Enable debugging output.

ENVIRONMENT

       QUERY_STRING Provided by the webserver CGI interface, this decides what graph to generate.

       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.

SEE ALSO

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