Argus - The All Seeing, System and Network Monitoring Software

Home
Features
Testimonials
Screen Shots
Demo
Download
Docs
History
Future
Links
Contributing
Mailing List
Contacting

Graphing

Graphing support was added in version 3.2

Additional Prerequisites

  • GD.pm is needed. this module in turn requires libgd, libjpeg, libpng, and possibly more.

Additional Directories

2 additional directories need to be created to contain graph data:

  • $datadir/gcache - needs to be writable by the web server. will contain cached graph images.
  • $datadir/gdata - needs to be writable by argusd and readable by the web server. will contain graph data, one ~100k file per item.

Enabling Graphing

Data from SNMP queries, TCP tests, UDP tests, external program tests, database queries, internal data, ping round-trip-times, test elapsed time, (etc.) can all be graphed. Groups of these can also be graphed. The default is not to graph. To enable, in the desired places, add:

	graph: yes

You can also set various other parameters. For Example:

	Group "Bandwidth Tests" {
		graph:     yes			# turn on graphing
		title:     Bandwidth		# set the graph title
		ylabel:    Bits per second	# label the y-axis
		drawgrid:  yes			# draw a grid
		Service UDP/SNMP {
			label:		Out
			# calc is documented elsewhere, but
			# this will convert the SNMP counter
			# to the average rate in bits/second
			calc:		ave-rate-bits
			hostname:       gw-amb3.example.com
			oid:		ifInOctets.1
			maxvalue:	20000000
			# maxvlue is documented elsewhere, but
			# this will cause the service to be
			# down if it exceeds 20 Mbps
			# when down, the graph will display red
		}
		Service UDP/SNMP {
			label:		In
			calc:		ave-rate-bits
			hostname:       gw-amb3.example.com
			oid:		ifOutOctets.1
			maxvalue:	20000000
		}
	}

The webpages will contain 3 thumb-nail images covering roughly: 1 day, 2 weeks, 3 months. Clicking on the thumb-nails will bring up a larger image. Some example images, click for larger: