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)