RRDTool - Revision history

Sstrutt: /* Installation */ Fix Windows download link

2012-11-19T21:28:01Z

Installation: Fix Windows download link

← Older revision		Revision as of 21:28, 19 November 2012
Line 12:		Line 12:
	#* <code> apt-get rrdtool </code>		#* <code> apt-get rrdtool </code>

	If you're installing on Windows see here - http://oss.oetiker.ch/mrtg/doc/mrtg-nt-guide.en.html. ~~To obtain just~~ rrdtool exe's for Windows ~~see here~~ - http://~~www~~.~~cacti~~.~~net~~/~~downloads~~/rrdtool/win32/		If you're installing on Windows see here - http://oss.oetiker.ch/mrtg/doc/mrtg-nt-guide.en.html. The rrdtool exe's for Windows can be found in the latest Win32-Perl package from http://oss.oetiker.ch/rrdtool/pub/?M=D (currently rrdtool-1.2.30-win32-perl510.zip, as of Nov 2012)

	=== Config Maker (cfgmaker) ===		=== Config Maker (cfgmaker) ===

2012-11-18T22:12:05Z

Installation: Added link to Win rrdtool exe's

← Older revision		Revision as of 22:12, 18 November 2012
Line 4:		Line 4:
	=== Installation ===		=== Installation ===
	This section assumes you want to install both RRDTool (which is responsible for managing and presenting data) and MRTG (which is responsible for data collection). Strictly speaking MRTG isn't needed, but when you're first getting started it makes things much easier.		This section assumes you want to install both RRDTool (which is responsible for managing and presenting data) and MRTG (which is responsible for data collection). Strictly speaking MRTG isn't needed, but when you're first getting started it makes things much easier.

	~~If you're installing on Windows see here - http://oss.oetiker.ch/mrtg/doc/mrtg-nt-guide.en.html~~

	To install on Ubuntu...		To install on Ubuntu...
Line 13:		Line 11:
	# Install RRDTool		# Install RRDTool
	#* <code> apt-get rrdtool </code>		#* <code> apt-get rrdtool </code>

			If you're installing on Windows see here - http://oss.oetiker.ch/mrtg/doc/mrtg-nt-guide.en.html. To obtain just rrdtool exe's for Windows see here - http://www.cacti.net/downloads/rrdtool/win32/

	=== Config Maker (cfgmaker) ===		=== Config Maker (cfgmaker) ===

2012-04-18T11:41:45Z

Added Monitoring category

2011-09-26T14:57:30Z

Getting Started: Added installation (in progress)

← Older revision		Revision as of 14:57, 26 September 2011
Line 2:		Line 2:

	== Getting Started ==		== Getting Started ==
			=== Installation ===
			This section assumes you want to install both RRDTool (which is responsible for managing and presenting data) and MRTG (which is responsible for data collection). Strictly speaking MRTG isn't needed, but when you're first getting started it makes things much easier.

			If you're installing on Windows see here - http://oss.oetiker.ch/mrtg/doc/mrtg-nt-guide.en.html

			To install on Ubuntu...
			# Install MRTG
			#* <code> apt-get mrtg </code>
			#* Answer yes to making mrtg.conf accessible by root only
			# Install RRDTool
			#* <code> apt-get rrdtool </code>

			=== Config Maker (cfgmaker) ===
			<code> cfgmaker --global "Interval: 1" --global "LogFormat: rrdtool" --global "Options[_]: bits,growright" --output /home/mrtg/cfg/mrtg.cfg public@router </code>

	== Create a Database ==		== Create a Database ==

2010-03-17T09:34:51Z

Added PHP

← Older revision		Revision as of 09:34, 17 March 2010
Line 83:		Line 83:
	LINE3:max#0000FF:"peak		LINE3:max#0000FF:"peak
	</pre>		</pre>


			== PHP ==

			http://www.ioncannon.net/system-administration/59/php-rrdtool-tutorial/

			[[Category:RRDTool]]
			[[Category:PHP]]

2010-03-16T13:59:51Z

Graphing: Added weekly

@@ Line 71: / Line 71: @@
 <pre>
 rrdtool graph graph.png DEF:cpu=svr-cpu.rrd:ds:AVERAGE LINE1:cpu#0000FF:"cpu usage"
 </pre>

2010-03-09T14:05:06Z

Retrieve From Database: Added "Graphing"

← Older revision		Revision as of 14:05, 9 March 2010
Line 67:		Line 67:

	== Retrieve From Database ==		== Retrieve From Database ==
			=== Graphing ===
			At minimum, you need to define the RRD from which you're going to plot data, a DEF (a data source definition), and a LINE (how to plot the data). The graph function assumes you want to plot for data in the RRD from 1 day ago to now.
			<pre>
			rrdtool graph graph.png DEF:cpu=svr-cpu.rrd:ds:AVERAGE LINE1:cpu#0000FF:"cpu usage"
			</pre>

2010-03-09T13:51:30Z

Update Database: Populated (section previously blank)

← Older revision		Revision as of 13:51, 9 March 2010
Line 56:		Line 56:

	== Update Database ==		== Update Database ==
			The following updates an RRD file with a number of (one or more) time:value pairs. The number of pairs is limited by the maximum command length the calling script can handle. Time should be in Unix seconds since Epoch (1/1/1970 00:00:00 UTC) format (you'll need to account for daylight savings if converting from a local time value).
			<pre>
			rrdtool update svr-cpu.rrd 1268138780:3.99 1268138800:4.16 1268138820:3.33 1268138840:3.94
			</pre>

			It can be useful to know when an RRD was last updated (eg so your script knows where its meant to be updating from, though this should be an interval later than the time returned). Note that if you've defined more than one dataset in an RRD then you'll get the latest update if the DSs aren't being updated in sync.
			<pre>
			rrdtool last svr-cpu.rrd
			</pre>

	== Retrieve From Database ==		== Retrieve From Database ==

2010-01-21T08:33:59Z

Added some section headings

2010-01-21T08:33:07Z

Create a Database: Corrected and annotated rrdtool create command

← Older revision		Revision as of 08:33, 21 January 2010
Line 36:		Line 36:
	** 366 day coverage = 366 x 24 x 60 = 527,040 mins = 527,040 / 24 x 60 = 366 averaged data points		** 366 day coverage = 366 x 24 x 60 = 527,040 mins = 527,040 / 24 x 60 = 366 averaged data points

	rrdtool create ~~esx1~~-cpu.rrd --step 20 \		The format of the create command is shown here http://oss.oetiker.ch/rrdtool/doc/rrdcreate.en.html, for the above example this becomes
	DS:CPU-Aggregate:GAUGE:40:0:100 \		<pre>
	RRA:AVERAGE:0.5:1:2160 \		rrdtool create svr-cpu.rrd --step 20 \ # Filename and raw data point interval
	RRA:AVERAGE:0.25:15:~~1440~~ \		DS:CPU-Aggregate:GAUGE:40:0:100 \ # The Datasource: name, type, max interval, min value, max value
	RRA:MIN:0.25:15:~~1440~~ \		RRA:AVERAGE:0.5:1:2160 \ # Raw data 'averaged' over 1 data point, ie raw data
	RRA:MAX:0.25:15:~~1440~~ \		RRA:AVERAGE:0.25:15:288 \ # Raw data averaged over 15 data points, 288 averages stored
			RRA:MIN:0.25:15:288 \ # Minimum value of raw data over 15 data points, 288 mins stored
			RRA:MAX:0.25:15:288 \ # Maximum value of raw data over 15 data points, 288 maxs stored
	RRA:AVERAGE:0.25:60:504 \		RRA:AVERAGE:0.25:60:504 \
	RRA:MIN:0.25:60:504 \		RRA:MIN:0.25:60:504 \
Line 51:		Line 53:
	RRA:MIN:0.25:4320:366 \		RRA:MIN:0.25:4320:366 \
	RRA:MAX:0.25:4320:366		RRA:MAX:0.25:4320:366
			</pre>