bionic (5) graphs.cfg.5.gz

Provided by: xymon_4.3.28-3build1_amd64 bug

NAME

       graphs.cfg - Configuration of the showgraph CGI

SYNOPSIS

       $XYMONHOME/etc/graphs.cfg

DESCRIPTION

       showgraph.cgi(1) uses the configuration file $XYMONHOME/etc/graphs.cfg to build graphs from the RRD files
       collected by Xymon.

FILE FORMAT

       Each definition of a graph type begins with a "[SERVICE]" indicator, this  is  the  name  passed  as  the
       "service"  parameter  to  showgraph.cgi(1).  If the service name passed to showgraph.cgi is not found, it
       will attempt to match the service name to a graph via  the  TEST2RRD  environment  variable.  So  calling
       showgraph.cgi with "service=cpu" or "service=la" will end up producing the same graph.

       A  graph  definition needs to have a TITLE and a YAXIS setting. These are texts shown as the title of the
       graph, and the YAXIS heading respectively.  (The X-axis is always time-based).

       If a fixed set of RRD files are used for the graph, you just write those in the RRDtool definitions. Note
       that  Xymon  keeps all RRD files for a host in a separate directory per host, so you need not worry about
       the hostname being part of the RRD filename.

       For graphs that use multiple RRD files as  input,  you  specify  a  filename  pattern  in  the  FNPATTERN
       statement,  and optionally a pattern of files to exclude from the graph with EXFNPATTERN (see "[tcp]" for
       an example).  When FNPATTERN is used, you can use "@RRDFN@" in the RRDtool definitions to  pick  up  each
       filename.  "@RRDIDX@"  is  an  index  (starting at 0) for each file in the set. "@RRDPARAM@" contains the
       first word extracted from the pattern of files (see e.g. "[memory]" how this is used). "@COLOR@" picks  a
       new color for each graph automatically.

       The remainder of the lines in each definition are passed directly to the RRDtool rrd_graph() routine.

       The following is an example of how the "la" (cpu) graph is defined. This is a simple definition that uses
       a single RRD-file, la.rrd:

       [la]
               TITLE CPU Load
               YAXIS Load
               DEF:avg=la.rrd:la:AVERAGE
               CDEF:la=avg,100,/
               AREA:la#00CC00:CPU Load Average
               GPRINT:la:LAST:  %5.1lf (cur)
               GPRINT:la:MAX:  %5.1lf (max)
               GPRINT:la:MIN:  %5.1lf (min)
               GPRINT:la:AVERAGE:  %5.1lf (avg)\n

       Here is an example of a graph that uses multiple RRD-files, determined automatically at run-time via  the
       FNPATTERN setting. Note how it uses the @RRDIDX@ to define a unique RRD parameter per input-file, and the
       @COLOR@ and @RRDPARAM@ items to pick unique colors and a matching text for the graph legend:

       [disk]
               FNPATTERN disk(.*).rrd
               TITLE Disk Utilization
               YAXIS % Full
               DEF:p@RRDIDX@=@RRDFN@:pct:AVERAGE
               LINE2:p@RRDIDX@#@COLOR@:@RRDPARAM@
               -u 100
               -l 0
               GPRINT:p@RRDIDX@:LAST:  %5.1lf (cur)
               GPRINT:p@RRDIDX@:MAX:  %5.1lf (max)
               GPRINT:p@RRDIDX@:MIN:  %5.1lf (min)
               GPRINT:p@RRDIDX@:AVERAGE:  %5.1lf (avg)\n

ADVANCED GRAPH TITLES

       Normally the title of a graph is a static text defined in the graphs.cfg  file.  However,  there  may  be
       situations  where  you  want  to  use  different  titles  for  the  same  type of graph, e.g.  if you are
       incorporating RRD files from MRTG into Xymon. In that case you can setup the TITLE definition so that  it
       runs a custom script to determine the graph title. Like this:

            TITLE exec:/usr/local/bin/graphitle

       The /usr/local/bin/graphtitle command is then called with the hostname, the graphtype, the period string,
       and all of the RRD files used as parameters. The script must generate one line of output, which  is  then
       used as the title of the graph.

ENVIRONMENT

       TEST2RRD Maps service names to graph definitions.

NOTES

       Most  of  the  RRD  graph  definitions  shipped  with  Xymon have been ported from the definitions in the
       larrd-grapher.cgi CGI from LARRD 0.43c.

SEE ALSO

       xymonserver.cfg(5), rrdtool(1), rrdgraph(1)