Develop and Download Open Source Software

#--------------------------------------------------------
# About LVS Statistics Grapher
#--------------------------------------------------------
############### READ THIS STATEMENT FIRST ##############
Of course I publish this program hoping this program is
useful for other people.
But, you have to use this program at your own risk.
I'm not responsible for your usage of this program.

#####################################################

Generate graph about ip_vs kernel module information.
This scripts generate following type of graph

All Virtual Server Aggregated graph
* Connection per sconds(CPS)
* Throughput(BPS)
* Active/Inactive Concurrent Connections

Per Virtual Server View
* Connection per sconds(CPS)
* Throughput(BPS)
* Active/Inactive Concurrent Connections
* Packets per seconds(PPS) and Average packet size
* Bit/connection and Packet/connection

################# IMPORTANT #############################

This scripts expect following commands to work properly.

/sbin/ipvsadm -L -n --stats --exact

And I strongly recomend to manage /etc/hosts file for
VIP entry which enable rrd_stats scripts use service name
as graph title.

#########################################################

#--------------------------------------------------------
* required software
#--------------------------------------------------------
ruby >= 1.8
ruby-rrdtool >= 1.2
rrdtool >= 1.2

#--------------------------------------------------------
# Files
#--------------------------------------------------------
ipvs_rrd.rb
=> library used to generate several type of graph.
index.cgi
=> GUI frontand which enable you to view graph via browser
lvs_rrdgraph.rb
=> generate graph from rrd database
lvs_rrdstore.rb
=> parse /sbin/ipvsadm output and store to rrd database
lvs_stats.sh
=> shell scripts executed from cron
color_list
=> color list which is used for all vs aggregated graph

#--------------------------------------------------------
# Install example
#--------------------------------------------------------
* install
#--------------------------------------------------------
cd /usr/local/src
tar xzf lvs_stats.tgz
mv lvs_stats /usr/local
cd /usr/local/lvs_stats

mkdir /usr/local/apache/htdocs/lvs_stats
mkdir /usr/local/apache/htdocs/lvs_stats/graph
mkdir /usr/local/apache/htdocs/lvs_stats/graph/{w,m,y}
mkdir /usr/local/apache/htdocs/lvs_stats/rrd
mv index.cgi /usr/local/apache/htdocs/lvs_stats
ln -s /usr/local/apache/htdocs/lvs_stats/graph
ln -s /usr/local/apache/htdocs/lvs_stats/rrd

* edit $LOAD_PATH of 'ipvs_rrd.rb' and 'lvs_rrdstore.rb'
$LOAD_PATH << 'path of directory where RRD.so reside'
#--------------------------------------------------------
* check
#--------------------------------------------------------
/usr/local/lvs_rrdstore.rb
ls -l rrd
/usr/local/lvs_rrdgraph.rb
ls -l graph

access following URL via browser
http://LVS_IP_ADDRESS/lvs_stats/index.cgi

#--------------------------------------------------------
* register to cron
#--------------------------------------------------------
mv lvs_stats.cron /etc/cron.d/lvs_stats

#--------------------------------------------------------

2009-01-18 t9md
* fix bug ( color of aggregated vs graph become monochrome )
this fix is quick fix, so supported number of virtual server is 50.
you can add more color to "color_list".

2008-11-25 t9md
* change initial RRD DataSource type for from COUNTER to DERIVE with minimal
value of '0'.

2008-11-24 t9md
* initial version released.