DEVMON GRAPHING IN HOBBIT
=====================================================================
-- Graphing tests with rrd repeater tables
----------------------------------
-------------------------------------------------------------------
One of the useful additions to devmon 0.3 is the rrd option to
repeater tables. For example, a TABLE line such as:
TABLE:rrd(DS:ds0:ifInOctets:COUNTER; DS:ds1:ifOutOctets:COUNTER)
will result in Devmon generatingan RRD header:
<!--DEVMON RRD: if_load 0 0
followed by the DS definitions:
DS:ds0:DERIVE:600:0:U DS:ds1:DERIVE:600:0:U
followed by the values for each instance, e.g.:
eth0.0 3506583:637886
In order for Hobbit to collect the values and update the RRD files, you
need to either use a script with the --extra-script option to
hobbitd_rrd (such as extras/devmon-rrd.pl) or use the supplied devmon
rrd collector module (extras/do_devmon.c) and the patch (
extras/hobbit-4.2.0-devmon.patch) which adds the collector to do_rrd.c.
Finally, you need to map each test for which you want to collect data
provided in the devmon format to be collected by the devmon collector,
by adding testname=devmon to TEST2RRD in hobbitserver.cfg (e.g.
if_load=devmon).
Finally, you need a graph definition, such as the one shipped in
extras/devmon-graph.cfg. If you use the "directory" feature in
Hobbit's hobbitgraph.cfg, you can simply copy the file to the
directory specified.
At present, most if_load tests support this method, and the compaq-server,
cisco-6509, and dell-poweredge templates support it for the 'temp' test.
---------------------------------------------------------------------
USING HOBBIT FEATURES FROM DEVMON
=====================================================================
For specific tests, Hobbit already parses information supplied in
specific formats (typically from old BigBrother extensions). You can
(ab)use this support to have Hobbit graph values from your own templates.
----------------------------------
-- The 'CPU' test
----------------------------------
-------------------------------------------------------------------
On any device, you would like to graph CPU.
If you get CPU usilisation value as a percentage, you should add
the following lines to the message file in the cpu directory in your
template:
<!--
<br>CPU 5 min average: {CPUTotal5Min}
-->
For example in:
cisco-asa/cpu/message
Where CPUTotal5Min is a percentage.
Wait for 2 passes, and you will get a graph
----------------------------------
-- The 'memory' test
----------------------------------
-------------------------------------------------------------------
On any device, you would like to graph memory usage.
You should add the following lines to the message file in the memory
directory in your template.
<!--
Physical {mem_used_per}%
-->
For example in:
cisco-asa/memory/message
Where mem_used_per is a percentage.
Way for 2 passes, and you will get a graph.
----------------------------------
-- Using ncv (e.g. the 'connects' test)
----------------------------------
-------------------------------------------------------------------
If you have a test where the value you want to graph is not a repeater
(so Devmon's RRD collector isn't useful), and it isn't for a test
that Hobbit already understands a specific format, then Hobbit's NCV
collector is probably the last remaining option. Add a Name-colon-value
line to your message, surrounded by HTML tags (if you want to hide the
line on the normal Hobbit display.
For example, to graph the numbers of connections you should add the
following lines to the message file in the connects directory in your
template:
Connections: {cur_conn}
For example in:
cisco-asa/connects/message
Where cur_conn is your number of connections you want to graph.
Then, add "connects=ncv" to TEST2RRD in hobbitserver.cfg, as well as the
RRD options for connects, via:
NCV_connects="*:GAUGE"
Finally, you need a graph definition for connects, such as the one shipped in
extras/devmon-graph.cfg
----------------------------------
$Id: GRAPHING 95 2008-12-07 19:58:38Z buchanmilne $
