Welcome to docs.opsview.com


This shows you the differences between two versions of the page.

opsview4.6:rrdgraphing [2014/09/09 12:19] (current)
Line 1: Line 1:
 +====== RRD Graphing ======
 +<note warning>RRD graphing is deprecated as it is superceded by the [[opsview4.6:interactivegraphs|interactive graphing]] functionality in Opsview. See our policy on [[deprecated_functionality|deprecated functionality]]. The following still exists, but may be withdrawn in future. RRD graphing is **not** considered to be an [[opsview4.6:apis|API]]</note>
 +You specify the graphs you want to draw via URL parameters. To get the RRD graph, use your browser to GET from /rrdgraph with some of the available options:
 +||duration     ||Defines the duration period. You can use any duration specifier RRD allows. Defaults to 1d||
 +||start        ||Defines the start time of the graph. You can use anything that RRD allows. Defaults to end-duration||
 +||end          ||Defines the end time of the graph. Defaults to now||
 +||height       ||Defines height of graph in pixels. Defaults to 200||
 +||width        ||Defines width of graph in pixels. Defaults to 400||
 +||graph_format ||Defines output format. Defaults to PNG||
 +||colours      ||A comma separated list of hex value colours||
 +||legend       ||Set to 0 to disable legend. Defaults to 1||
 +||stack        ||Set to 1 to show a stacked output. Beware, if any values are Unknown, the whole stack for that datapoint will not be shown||
 +||host         ||Hostname (as defined in Opsview) to draw graph for. Use multiple parameters for more hosts. You must specify at least 1 host||
 +||service      ||Service name to draw graph for. Use multiple parameters for more services. You must specify at least 1 service. Only the requested hosts that have the requested services will have their values drawn||
 +||metric       ||Metric to draw. Defaults to all metrics on each host/service||
 +||title        ||Title for the graph ||
 +||vertical-label||Vertical title on left hand side ||
 +||only-graph||If height < 32 and only-graph specified then a thumbnail will be created with labelling stripped off  ||
 +||upper-limit||Define the upper limit of the y axis data range||
 +||lower-limit||Define the lower limit of the y axis data range||
 +||rigid||Do not allow the upper or lower limits to be automatically modified||
 +||alt-autoscale||Calculate the minimum and maximum y-axis from the actual minimum and maximum data values||
 +||alt-autoscale-max||Calculate the maximum y-axis from data values||
 +||no-gridfit|| Disable snapping points to device resolution pixels||
 +||x-grid||Define how grid lines are set on the x-axis||
 +||y-grid||Define how grid lines are set on the y-axis||
 +||alt-y-grid||Place the Y grid dynamically based on the graph's Y range||
 +||logarithmic||Use logarithmic y-axis scaling||
 +||units-exponent||Sets the 10**exponent scaling of the y-axis values||
 +||units-length||Number of digits rrdtool assumes y-axis labels to be||
 +||units||Y-axis values on logarithmic graphs will be scaled to the appropriate units instead of using exponential notation||
 +||zoom||Zoom the graphics by the given amount||
 +||font-render-mode||Specify the font render mode: normal, light or mono||
 +||font-smoothing-threshold||Specify the largest font size to be rendered bitmapped||
 +||pango-markup||Process all text using pango markup (to allow embedding markup tags_||
 +||graph-render-mode||Specify rendering mode: normal, mono||
 +||slope-mode||Smooth out graphs to a slope rather than stepped lines||
 +||interlaced||Interlace images so they may appear in browsers more quickly||
 +||base||Either 1000 or 1024 depending on whether or not units are bytes.  Def: 1000||
 +||multiplier||If perfdata returned by a check is not in the smallest unit (i.e. Mb not B), use the multiplier to correct the data so the graph displays properly (e.g. if the graphs store values in Mb to B use 1048576 which is 1024 * 1024) ||
 +If a graph cannot be generated, a web page will be returned with the error message.  There are further details on some of the above options on the ''rrdgraph'' man page on your system.
 +By default, the URL /rrdgraph is public. You can change this setting in System Preferences. If it is not public, then you will to authenticate before being able to view the graph, and authorisation is based on the [[access|access rules]].
 +===== Examples =====
 +=== /rrdgraph?host=vmhost1&host=vmhost2&service=/&duration=3m ===
 +Returns a graph with the metric for / on vmhost1 and vmhost2 over the last 3 months.
 +===== References =====
 +See RRD tool graphing options: http://oss.oetiker.ch/rrdtool/doc/rrdgraph.en.html
 +===== Changes from Opsview 2.14 =====
 +There was a limitation where metric names were truncated in Opsview 2.14. Opsview 3 removes this limitation. To do this, RRDs need to be converted from the old structure to the new structure.
 +The old RRDs had:
 +  * a filename of {hostname}_{servicename}_{db}.rrd
 +  * with multiple data sources of the metric names
 +  * and {metricname}_warn or {metricname}_crit for the thresholds
 +The new RRDs have:
 +  * a directory structure of {hostname}/{servicename}/{metric}/value.rrd
 +  * with a data source name of "value"
 +  * if thresholds are included, a filename of {hostname}/{servicename}/{metric}/thresholds.rrd
 +  * with data source names of "warning_end" and "critical_end"
 +The conversion should happen automatically as part of the [[opsview3.0:upgrading_from_2.14#rrd_migration|upgrade from 2.14 to 3]].
 +We have deprecated show.cgi in place of /rrdgraph.