haproxy-stat

Simplify getting info and stats from a local haproxy stat file socket.


Install

npm install haproxy-stat

Module Usage

var haproxystat = require('haproxy-stat');
var hastat = haproxystat({ socketPath: '/tmp/haproxy.sock' });

$3

Get basic info from HAProxy.

hastat.showInfo(function (err, data) {
console.log(data);
});

data is an object with the following properties:

{
name: 'HAProxy',
version: '1.4.18',
release_data: '2011/09/16',
nbproc: '1',
process_num: '1',
pid: '30984',
uptime: '0d 2h01m42s',
uptime_sec: '7302',
mem_max_mb: '0',
ulimit_n: '8210',
max_sock: '8210',
max_conn: '4096',
max_pipes: '0',
current_conns: '2',
pipes_used: '0',
pipes_free: '0',
tasks: '5',
run_queue: '1',
node: 'haproxyserver-0',
development: ''
}

$3

Get data from HAProxy stats via show stats command. Detailed date described here.

hastat.showStat(function (err, data) {
console.log(data);
});

data is an array of objects like the following:

[
{
pxname: 'ldap',
svname: 'FRONTEND',
qcur: '',
qmax: '',
scur: '0',
smax: '0',
slim: '2000',
stot: '0',
bin: '0',
bout: '0',
dreq: '0',
dresp: '0',
ereq: '0',
econ: '',
eresp: '',
wretr: '',
wredis: '',
status: 'OPEN',
weight: '',
act: '',
bck: '',
chkfail: '',
chkdown: '',
lastchg: '',
downtime: '',
qlimit: '',
pid: '1',
iid: '2',
sid: '0',
throttle: '',
lbtot: '',
tracked: '',
type: 'frontend',
rate: '0',
rate_lim: '0',
rate_max: '0',
check_status: {
code: '',
description: ''
},
check_code: '',
check_duration: '',
hrsp_1xx: '',
hrsp_2xx: '',
hrsp_3xx: '',
hrsp_4xx: '',
hrsp_5xx: '',
hrsp_other: '',
hanafail: '',
req_rate: '0',
req_rate_max: '0',
req_tot: '0',
cli_abrt: '',
srv_abrt: ''
},
{
pxname: 'agent',
svname: 'agent_10.10.2.125:8080',
qcur: '0',
qmax: '0',
scur: '0',
smax: '0',
slim: '',
stot: '0',
bin: '0',
bout: '0',
dreq: '',
dresp: '0',
ereq: '',
econ: '0',
eresp: '0',
wretr: '0',
wredis: '0',
status: 'UP',
weight: '1',
act: '1',
bck: '0',
chkfail: '0',
chkdown: '0',
lastchg: '99',
downtime: '0',
qlimit: '',
pid: '1',
iid: '5',
sid: '2',
throttle: '',
lbtot: '0',
tracked: '',
type: 'server',
rate: '0',
rate_lim: '',
rate_max: '0',
check_status: {
code: 'L4OK',
description: 'check passed on layer 4, no upper layers testing enabled'
},
check_code: '',
check_duration: '0',
hrsp_1xx: '0',
hrsp_2xx: '0',
hrsp_3xx: '0',
hrsp_4xx: '0',
hrsp_5xx: '0',
hrsp_other: '0',
hanafail: '0',
req_rate: '',
req_rate_max: '',
req_tot: '',
cli_abrt: '0',
srv_abrt: '0'
},
{
pxname: 'agent',
svname: 'BACKEND',
qcur: '0',
qmax: '0',
scur: '0',
smax: '0',
slim: '0',
stot: '0',
bin: '0',
bout: '0',
dreq: '0',
dresp: '0',
ereq: '',
econ: '0',
eresp: '0',
wretr: '0',
wredis: '0',
status: 'UP',
weight: '2',
act: '2',
bck: '0',
chkfail: '',
chkdown: '0',
lastchg: '99',
downtime: '0',
qlimit: '',
pid: '1',
iid: '5',
sid: '0',
throttle: '',
lbtot: '0',
tracked: '',
type: 'backend',
rate: '0',
rate_lim: '',
rate_max: '0',
check_status: {
code: '',
description: ''
},
check_code: '',
check_duration: '',
hrsp_1xx: '0',
hrsp_2xx: '0',
hrsp_3xx: '0',
hrsp_4xx: '0',
hrsp_5xx: '0',
hrsp_other: '0',
hanafail: '',
req_rate: '',
req_rate_max: '',
req_tot: '',
cli_abrt: '0',
srv_abrt: '0'
}
]

var longDescrption = hastat.statDescription(property);

like:

var longDescrption = hastat.statDescription('rate');
console.log(longDescription);

results in:

number of sessions per second over last elapsed second

CLI

./node_modueles/.bin/haproxystat

or if installed globally:

npm install -g haproxy-stat
haproxystat

Usage:

Usage: node cli
command -> showInfo, showStat
socket_path -> /tmp/haproxy.sock (for example)