README.md

lvs-metrics ^{_{lvs metrics collector for open-falcon}}

lvs metrics collector for open-falcon.

Dependencies

• libnl3
• ipvs
• netlink
• toolkits
• glog

Dependencies are handled by godep, simple install it and type godep restore to fetch them.

Install

The libnl3 needed in compile and production machine.

# sudo yum install -y libnl3.x86_64
or
# sudo apt-get install libnl-3-dev libnl-genl-3-dev

Only needed in compile machine.

$ git clone https://github.com/mesos-utility/lvs-metrics.git
$ cd lvs-metrics
$ make bin

Configuration

Edit cfg.json configuration file.

{
    "debug": false,
    "attachtags": "",
    "http": {
        "enable": false,
        "listen": "0.0.0.0:1987"
    },
    "transfer": {
        "enable": true,
        "addr": "http://127.0.0.1:1988/v1/push", # Installed falcon agent in host.
        "interval": 30,
        "timeout": 1000
    }
}

or

{
    "debug": false,
    "attachtags": "",
    "http": {
        "enable": false,
        "listen": "0.0.0.0:1987"
    },
    "transfer": {
        "enable": true,
        "addr": "127.0.0.1:8433", # Send metrics to transfer direct.
        "interval": 30,
        "timeout": 1000
    }
}

Metrics

Counters	Type	Notes
lvs.in.bytes	GUAGE	network in bytes per host
lvs.out.bytes	GUAGE	network out bytes per host
lvs.in.packets	GUAGE	network in packets per host
lvs.out.packets	GUAGE	network out packets per host
lvs.total.conns	GUAGE	lvs total connections per host
lvs.vip.active_conn	GUAGE	lvs active connections per vip now
lvs.vip.inact_conn	GUAGE	lvs inactive connections per vip now
lvs.vip.rs_num	GUAGE	lvs live realserver num per vip now
lvs.vip.conns	COUNTER	lvs conns counter from service start per vip
lvs.vip.inbytes	COUNTER	lvs inbytes counter from service start per vip
lvs.vip.outbytes	COUNTER	lvs outpkts counter from service start per vip
lvs.vip.inpkts	COUNTER	lvs inpkts counter from service start per vip
lvs.vip.outpkts	COUNTER	lvs outpkts counter from service start per vip