= {fieldname}.line =

{{{{fieldname}.line}}} is an optional attribute creates a horizontal line in the graph.

== Properties == 

||Attribute name||{fieldname}.line||
||Value||Value [:color [:label]]||
||Allowed characters||Everything except {{{:}}} (splits the fields) and {{{#}}} (interpreted as comment).||
||Spaces allowed||Yes||
||Context||[wiki:datasource-specific_plugin_attributes Datasource-specific plugin attributes]||
||Required||No||
||Default value||The default color is red (#FF0000)||

== Caveats ==

'''Please note that neither the line nor its legend will not be visible if its value is outside the graph's scale.''' If it is desirable that the line will show at all times, please consider adding {{{--upper-limit <value>}}} to [wiki:graph_args graph_args].

Also note that this attribute initiates RRD's {{{HRULE}}}, and not RRD's {{{LINE}}}.

== Example ==

In the example below, [wiki:munin-graph munin-graph] will draw a green horizontal line (HRULE) at the value 5. Also, an entry will appear in the legend with whatever was entered as label.

{{{
# munin-run apt config
graph_title Pending packages
graph no
pending.label pending
pending.warning 0:0
pending.line 5:00ff00:Limit
hold.label hold
}}}

== Notes ==

{{{{fieldname}.line}}} accepts up to three arguments, separated by a colon (:).

 * The first (which is required) is the value at which the line should be drawn.
 * The second is the color, given in hex RGB format, i.e. RRGGBB.
 * The third argument is the label, allowing all characters except colon (which will be suppressed).

== Further documentation ==
See the [http://oss.oetiker.ch/rrdtool/doc/rrdgraph_graph.en.html RRD documentation] for more details.