Opsview's graphing screens use Flot.
This provides a way of getting information quickly to understand how a performance metric is running, so you can have trend information.
From a service, you can click the graphing icon to enter the graphing screens.
This will display a single page with one graph for each performance metric that has the same unit of measurement.
A basic graph has an overview section, which displays a graph over the whole year, and a main graph which displays a detailed view. The overview will be highlighted with the specific range currently in the main view.
At the top is a title for the graph. Click on it to change the title.
At the left side is a Y axis label (note, you may need to install an SVG plugin to display). Click on it to change the label.
The configuration of the graph is saved within a URL. Click on the Link button to get the link. Alternatively, you can access the link for the page which holds configuration for all graphs on the page.
You can resize the graph by dragging the small bevel control in the bottom right of the graph.
The legend for the graph can be hovered over to display the max/min/average values. You can click on the legend to hide or display the plot values.
Within the main graph, you can move the mouse pointer near a plot point and a hover over will display the time, the automatic value and the raw value for that plot point.
The time displayed for a plot point and the time for the x axis tick marks are in the Opsview server timezone. (In Opsview 3.5.0, this was a bug and always showed UTC time). However, the server timezone offset is calculated at a moment in time, based on the current time now. This means there maybe a difference in the time values when you load the page before a DST change or after. This is a limitation in flot because times are not normalised there.
If you have the Snap to Now option set, then the right hand side of the graph will be anchored to the latest Opsview server time (assuming your browser has its clock correctly synchronised with the server). In Opsview 3.6.0, the Snap to Now setting is displayed as a toggle on the toolbar. It is automatically disabled if you select a portion of the graph which is not anchored to the right hand side.
When the graphs first load, it will be snapped to now, which means the right column will be aligned to now.
You can use the left and right panning icons to move the view to the left or the right.
Note the resolution of the graphs may change as you pan - this is because the data points are stored in RRD which holds various different resolutions for the data and changing the ranges may change the resolution of the data.
As you pan left and right, the y-axis will remain the same. This is because the y-axis is set based on the maximum and minimum values from the overview. If you need to rescale the y-axis, you can click the Autoscale Y axis button - this will change the Y-axis value based on the maximum and minimum values within the main graph. In Opsview 3.6.0, the Autoscale button is a toggle. If it is on, then the graph will rescale according to the minimum and maximum values within the graph, otherwise it will keep to the same y-axis based on the overview graph.
You can click on the zoom sizes for predefined ranges. The ranges will be either anchored to now (if snap to now is set) or from the center of the main graph.
The predefined zoom sizes are:
- 1h - 1 hour
- 1d - 1 day
- 1w - 1 week
- 1M - 1 month
- 4M - 4 months
- 1y - 1 year
You can also zoom into any arbitrary range by dragging either the main graph area or the overview.
Note: The graph options in IE7 can overlay subsequent graphs. This will be fixed in later versions.
You can change the graph type to:
- Line (with points)
Y units allow you to change the prefix of units on the y-axis. The prefix range will go from:
If the unit of measurement is bytes, then the prefix range will go from:
Note: If you change the series, the y-axis drop down options will not change - it is only calculated at page load time.
Show legend can show or hide the legends within the graphs.
Snap to now will take the current main graph range and anchor it to now. It will also automatically update as new data is received in Opsview. See the section about times if the time zone of the browser is different from the time zone of the server.
The list of series will be in the graph options section as the label name. You can click on the label to edit it.
You can click on the delete button to remove the series from the graph.
The threshold button will toggle whether the thresholds will be displayed or not. Note: some series may not have thresholds.
You can add extra series to an existing graph. Enter the host name, service name and metric name. An autocomplete list will appear filtered by existing entries.
It has been seen that the JSON data returned back have timestamps which are not expected. This means that flot will draw the lines outside of the windowed view.
Use Firebug to check the JSON data returned.
This has been seen where there is an error updating an RRD which causes the import daemon to fail. Please let us know on the forums if this is happening so we can fix this.
- Check if
- If not, in /usr/local/nagios/etc/Log4perl.conf, uncomment log4perl.logger.import_perfdatarrd=DEBUG
/usr/local/nagios/etc/nagiosgraph.conf, set debug = 5
- In two new terminals, run
tail -f /var/log/opsview/opsviewd.logand
tail -f /usr/local/nagios/var/log/nagiosgraph.log
- In original terminal, run
- Observe your log files and note where it fails. For instance, if it fails under the host tpec. Please tar up these files and send them via anonymous ftp to ftp.opsera.com in the uploads directory and then raise a forum question, so we can look at this problem. If you do not care about the historical rrds for this host, you can remove all the RRD files with
rm -r /usr/local/nagios/var/rrd/tpec/
- Repeat 6 and 7 until there are no more errors
- Undo the debug output from 2 and 3