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