- This should be a complete list of configuration option keywords.
Default values for many of these configuration strings can be found in
the Default.conf file.
RRDTemplate[target]: The template for creating a .rrd file.
RRDArchive[target]: The directory for storing old .rrd files.
RunScript[target]: The run script to use to gather and archive
data for the target.
GetTimeout[target]: The timeout for collecting data from snmpget
or some other collector.
WebRootDir[target]: The part of the absolute path to your
web pages that does not show up in URLs.
ImageDir[target]: The URL path to the directory that contains
rrdtool+nrg.gif and other general .gif files.
RRD[target]: The URL path and file name for an RRD.
System[target]: The domain name or IP address of a system to
collect statistics from. This configuration
string also supports the name:port syntax to
allow for getting SNMP stats from SNMP agents
at ports other than the usual port 161.
Variable[target][ds]: For gathering SNMP stats, this should be
set to an SNMP OID. For gathering other
stats, this sould be set to a Unix command
enclosed in backticks ("`"). The OID may be
abbreviated by using an abbreviation that
appears in the etc/nrg-oid-names file.
MaximumValue[target]: The maximum value of the data sources
associated with "target". The MaximumValue
always refers to the processed values of a DS.
If this maximum value is know, use it! Using
this keyword causes RRDtool to do simple sanity
checks. Specifically, correctly using this
keyword causes RRDtool to correctly handle
COUNTER roll-overs and resets.
GraphPageTemplate[target]: The template to use for creating rrdcgi
scripts that graph an RRD.
Label[target][var]: The label for a variable that appears inside
an RRDtool gif file.
CalcDef[target][var]: An RPN expression that alters the "ds"
part of a Variable statement or the "var"
part of another/other CalcDef statement(s).
Graph[target][ds|var]: The color and type that specifies how a DS
should be graphed. For example, "blue
LINE2" to draw a blue line two pixels wide.
NOTE: TESTME the ds/var part of this keyword
can *not* be a perl regular expression.
UpperLimit[target]: This is not the upper limit of a graph! But
rather, this is the minimum upper bound
of a graph. Use this keyword to expand
graphs up. For example, the value 100 will
result in graphs that have a upper bound
of 100 or *more*. Setting the UpperLimit to
the maximum value for some DS will result
in disabling RRDtool's autoscaling down
(ie it will "expand" graphs up.) To disable
RRDtool's autoscaling up (to the max
value for the DSs graphed), use a nifty
CalcDef like so:
CalcDef[somerrd][mcpu]: cpu,100,GT,100,cpu,IF
If this CalcDef is applied to all DSs in a
graph, then the graph will have an upper limit
of 100.
LowerLimit[target]: This is not the lower limit of a graph. But
rather, this is the maximum lower bound of
a graph. For example, the value -100 will
result in a graph that has a lower limit of
-100 or less. Use this keyword to expand
graphs down.
YLabel[target]: The label for the Y axis (that appears inside
RRDtool gifs on the left hand side.)
GraphPrint[target]: The valid values for this keyword are ave, max,
and last. This keyword defines what DS values
will appear (inside RRDtool gifs) after the DS
labels.
Units[target]: The label to put after ave, max and/or last.
To autoscale a DS value printed inside an
RRDtool gif, use the string %s inside it's
Units keyword definintion. For example,
"%sb/s" might display as "20 b/s", "30 Kb/s",
"20 Mb/s".
UnitsExponent[target]: Do fixed autoscaling of the quantity labels
for the y-axis. Use the value zero to disable
y-axis quantity label autoscaling. Use the
value 6 (when graphing bytes) to fix y-axis
quantity labels to megabytes, etc.
PageTitle[target]: The HTML <TITLE> tag for a graph web page.
PageTop[target]: The HTML header for a graph web page.
PageBody[target]: The HTML body for a graph web page.
PageBottom[target]: The HTML footer for a graph web page.
TableWebPage[target]: Defines a table web page that should be
created by nrg-tablemaker
TableRegExp[target]: The perl regular expression that specifies
which graph web pages should be listed in an
table web page.
TableTitle[target]: The HTML <TITLE> tag for a table web page.
Base[]: This refers to the conversion factor for
converting some units to kilo units. For
networks, the default value of 1000 is correct
(1 kbit/sec == 1000 bit/sec). For memory
and disk storage the correct value is 1024
(1 kbyte == 1024 bytes)