Plugin reference

Fields

On a configuration run, the plugin is called with the argument “config”. The following fields are used.

Field Value type Description See also Default
graph_title string required Sets the title of the graph    
graph_args string optional Arguments for the rrd grapher. This is used to control how the generated graph looks, and how values are interpreted or presented. rrdgraph  
graph_vlabel string optional Label for the vertical axis of the graph    
graph_category lower case string, no whitespace optional Category used to sort the graph on the generated index web page.   misc
graph_info html text optional Additional text for the generated graph web page    
graph_scale yes|no optional If “yes”, the generated graph will be scaled to the uppper and lower values of the datapoints within the graph.   no
graph_order space separated list of graph.datapoints optional

Ensures that the listed datapoints are displayed in order. Any additional datapoints are added in the order of appearance after datapoitns appearing on this list.

This field is also used for “borrowing”, which is the practice of taking datapoints from other graphs.

   
update_rate integer (seconds) optional

Sets the update_rate used by the munin master when it creates the RRD file.

The update rate is the interval at which the RRD file expects to have data.

This field requires a munin master version of at least 2.0.0

   
datapoint.label lower case string, no whitespace required The label used in the graph for this field    
datapoint.info html text optional Additional html text for the generated graph web page, used in the field description table    
datapoint.warning integer, or integer:integer (signed) optional This field defines a threshold value or range. If the field value above the defined warning value, or outside the range, the service is considered to be in a “warning” state.    
datapoint.critical integer, or integer:integer (signed) optional This field defines a threshold value or range. If the field value is above the defined critical value, or outside the range, the service is considered to be in a “critical” state.    
datapoint.graph yes|no optional Determines if this datapoint should be visible in the generated graph.   yes
datapoint.cdef CDEF statement optional

A CDEF statement is a Reverse Polish Notation statement used to construct a datapoint from other datapoints.

This is commonly used to calculate percentages.

cdeftutorial  
datapoint.draw AREA, LINE, LINE[n], STACK, AREASTACK, LINESTACK, LINE[n]STACK   Determines how the graph datapoints are displayed in the graph. The “LINE” takes an optional width suffix, commonly “LINE1”, “LINE2”, etc… The *STACK values are specific to munin and makes the first a LINE, LINE[n] or AREA datasource, and the rest as STACK. rrdgraph LINE

On a data fetch run, the plugin is called with no arguments. the following fields are used.

Field Value type Description See also Default
datapoint.value integer, scientific notation, or “U” (may be signed) required The value to be graphed.   No default

Example

This is an example of the plugin fields used with the “df” plugin. The “munin-run” command is used to run the plugin from the command line.

Configuration run

# munin-run df config
graph_title Filesystem usage (in %)
graph_args --upper-limit 100 -l 0
graph_vlabel %
graph_category disk
graph_info This graph shows disk usage on the machine.
_dev_hda1.label /
_dev_hda1.info / (ext3) -> /dev/hda1
_dev_hda1.warning 92
_dev_hda1.critical 98

Data fetch run

# munin-run df
_dev_hda1.value 83