2005-10-20
Unnoc 1.0.4
Jason Schoonover

Unnoc RRD tuning, upgrading from 1.0.4 ONLY

Currently there are a few files that are included with 1.0.5 that will
upgrade the RRD's to their corrected values.

When I initially implemented RRD support, I did not plan for the future,
so I set the limits too low for all of the RRD files.  I also did not
include a high enough number for the amount of samples required to make
daily and weekly graphs, this is very apparant by their "blocky"
appearance.  I've added two scripts that will fix this:


	stats-rrd-fix.sh
	stats-rrdtune.pl


1. stats-rrd-fix.sh

The stats-rrd-fix.sh script will run through and replace all RRD's with the
corrected RRA values.  You can easily notice old RRD's by looking at the
daily graph.  If it looks like a "blocky" graph (each 20 minute interval
is covered with one big bar graph) then you need to update it.  It will
update the daily RRA from 120 to 600, and update the weekly RRA from 400
to 700.  This means that there are 600 samples required to make one full
daily graph and there are 700 samples required to make one full weekly
graph.  This also means that RRD wasn't storing enough information, so
it will shorten you graph.  There was not any information removed,
rather there wasn't enough stored to begin with.

These changes make the graphs look much, much better.

Keep in mind, this *only* has to be run if you're upgrading from 1.0.4.

It's a shell script, and it ain't pretty.  Mainly because the 'rrdtool
resize' command doesn't allow you to make the output to a separate file,
it saves it to a file called resize.rrd.  So basically I had to write a
script that would make a tmp directory for every rrd, and change to that
dir, and then run the script, and then mv the file back to the original.
It's just time consuming.  I've tried to write it as best as possible as
to not fail.  Time for me was approximately 20 seconds for 20 servers
(approximately 360 RRD's).


2. stats-rrdtune.pl

The stats-rrdtune.pl will update the minimum value and heartbeat values
in the RRD's.  I set them too low initially, so this should help for
growth.

The minimum count on all RRD's is set to 0 (changed from unknown).
The heartbeat is changed from 300 to 86400.

This one is quicker, only a few seconds depending on how many servers
and what type of server hardware you have.




vim:tw=72:wm=1