- 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)