Welcome to docs.opsview.com

RRD Graphing

RRD graphing is deprecated as it is superceded by the interactive graphing functionality in Opsview. See our policy on deprecated functionality. The following still exists, but may be withdrawn in future. RRD graphing is not considered to be an API

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:

ParameterDescription
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-labelVertical title on left hand side
only-graphIf height < 32 and only-graph specified then a thumbnail will be created with labelling stripped off
upper-limitDefine the upper limit of the y axis data range
lower-limitDefine the lower limit of the y axis data range
rigidDo not allow the upper or lower limits to be automatically modified
alt-autoscaleCalculate the minimum and maximum y-axis from the actual minimum and maximum data values
alt-autoscale-maxCalculate the maximum y-axis from data values
no-gridfit Disable snapping points to device resolution pixels
x-gridDefine how grid lines are set on the x-axis
y-gridDefine how grid lines are set on the y-axis
alt-y-gridPlace the Y grid dynamically based on the graph's Y range
logarithmicUse logarithmic y-axis scaling
units-exponentSets the 10**exponent scaling of the y-axis values
units-lengthNumber of digits rrdtool assumes y-axis labels to be
unitsY-axis values on logarithmic graphs will be scaled to the appropriate units instead of using exponential notation
zoomZoom the graphics by the given amount
font-render-modeSpecify the font render mode: normal, light or mono
font-smoothing-thresholdSpecify the largest font size to be rendered bitmapped
pango-markupProcess all text using pango markup (to allow embedding markup tags_
graph-render-modeSpecify rendering mode: normal, mono
slope-modeSmooth out graphs to a slope rather than stepped lines
interlacedInterlace images so they may appear in browsers more quickly
baseEither 1000 or 1024 depending on whether or not units are bytes. Def: 1000
multiplierIf 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 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

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 upgrade from 2.14 to 3.

We have deprecated show.cgi in place of /rrdgraph.

Navigation
Print/export
Toolbox