mirror of
http://git.haproxy.org/git/haproxy.git/
synced 2024-12-11 14:05:12 +00:00
2c6962c3c0
Currently there is a ~16KB limit for a data size passed via unix socket.
It is caused by a trivial bug ttat is going to fixed soon, however
in most cases there is no need to dump a full stats.
This patch makes possible to select a scope of dumped data by extending
current "show stat" to "show stat [<iid> <type> <sid>]":
- iid is a proxy id, -1 to dump all proxies
- type selects type of dumpable objects: 1 for frontend, 2 for backend, 4 for
server, -1 for all types. Values can be ORed, for example:
1+2=3 -> frontend+backend.
1+2+4=7 -> frontend+backend+server.
- sid is a service id, -1 to dump everything from the selected proxy.
To do this I implemented a new session flag (SN_STAT_BOUND), added three
variables in data_ctx.stats (iid, type, sid), modified dumpstats.c and
completely revorked the process_uxst_stats: now it waits for a "\n"
terminated string, splits args and uses them. BTW: It should be quite easy
to add new commands, for example to enable/disable servers, the only problem
I can see is a not very lucky config name (*stats* socket). :|
During the work I also fixed two bug:
- s->flags were not initialized for proto_uxst
- missing comma if throttling not enabled (caused by a stupid change in
"Implement persistent id for proxies and servers")
Other changes:
- No more magic type valuse, use STATS_TYPE_FE/STATS_TYPE_BE/STATS_TYPE_SV
- Don't memset full s->data_ctx (it was clearing s->data_ctx.stats.{iid/type/sid},
instead initialize stats.sv & stats.sv_st (stats.px and stats.px_st were already
initialized)
With all that changes it was extremely easy to write a short perl plugin
for a perl-enabled net-snmp (also included in this patch).
29385 is my PEN (Private Enterprise Number) and I'm willing to donate
the SNMPv2-SMI::enterprises.29385.106.* OIDs for HAProxy if there
is nothing assigned already.
112 lines
4.9 KiB
Plaintext
112 lines
4.9 KiB
Plaintext
SNMP support for HAProxy
|
|
Copyright 2007-2008 Krzysztof Piotr Oledzki <ole@ans.pl>
|
|
|
|
Root OID: 1.3.6.1.4.1.29385.106
|
|
|
|
Files:
|
|
- README: this file
|
|
- haproxy.pl: Net-SNMP embedded perl module
|
|
- haproxy_backend.xml: Cacti snmp-query definition for backends
|
|
- haproxy_frontend.xml: Cacti snmp-query definition for frontends
|
|
|
|
Install:
|
|
cp haproxy.pl /etc/snmp/
|
|
grep -q "disablePerl false" /etc/snmp/snmpd.conf || echo "disablePerl false" >> /etc/snmp/snmpd.conf
|
|
echo "perl do '/etc/snmp/haproxy.pl';" >> /etc/snmp/snmpd.conf
|
|
|
|
Supported commands:
|
|
- GET (snmpget, snmpbulkget): quite fast.
|
|
- GETNEXT (snmpwalk, snmpbulkwalk): not so fast as requires to transfer
|
|
and parse a lot of data during each step. Always use "get" instead of "walk"
|
|
if that's possible.
|
|
|
|
Supported OIDs:
|
|
- 1.3.6.1.4.1.29385.106.1: get a variable from stats
|
|
Usage: 1.3.6.1.4.1.29385.106.1.$type.$field.$iid.$sid
|
|
|
|
- type is one of:
|
|
0) frontend
|
|
1) backend
|
|
2) server
|
|
|
|
- field is one of:
|
|
0..32) CSV format variable
|
|
10001) index
|
|
10002) unique name
|
|
|
|
- iid is a proxy id
|
|
|
|
- sid is a service id (sid): 0 for frontends and backends, >= 1 for servers
|
|
|
|
- 1.3.6.1.4.1.29385.106.2: get a variable from info
|
|
Usage: 1.3.6.1.4.1.29385.106.2.$req.$varnr
|
|
|
|
- req is one of:
|
|
0) get variable name
|
|
1) gat variable value
|
|
|
|
Examples:
|
|
|
|
- Get a list of frontends (type: 0) with status (field: 17):
|
|
$ snmpbulkwalk -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.1.0.17
|
|
SNMPv2-SMI::enterprises.29385.106.1.0.17.1.0 = STRING: "OPEN"
|
|
SNMPv2-SMI::enterprises.29385.106.1.0.17.47.0 = STRING: "OPEN"
|
|
|
|
- Get a list of backends (type: 1) with index (field: 10001):
|
|
$ snmpbulkwalk -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.1.1.10001
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1.0 = STRING: "1.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1100.0 = STRING: "1100.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1101.0 = STRING: "1101.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1200.0 = STRING: "1200.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1201.0 = STRING: "1201.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1300.0 = STRING: "1300.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1400.0 = STRING: "1400.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1401.0 = STRING: "1401.0"
|
|
SNMPv2-SMI::enterprises.29385.106.1.1.10001.1500.0 = STRING: "1500.0"
|
|
(...)
|
|
|
|
- Get a list of servers (type: 2) with unique name (field: 10002):
|
|
$ snmpbulkwalk -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.1.2.10002
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1100.1001 = STRING: "backend1/s2"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1100.1002 = STRING: "backend1/s5"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1100.1003 = STRING: "backend1/s6"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1100.1012 = STRING: "backend1/s7"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1101.1001 = STRING: "backend2/s9"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1101.1002 = STRING: "backend2/s10"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1101.1003 = STRING: "backend2/s11"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1101.1012 = STRING: "backend2/s12"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.10002.1200.1001 = STRING: "backend3/s8"
|
|
(...)
|
|
|
|
- Get a list of servers (type: 2) with weight (field: 18) in proxy 4300:
|
|
$ snmpbulkwalk -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.1.2.18.4300
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.18.4300.1001 = STRING: "40"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.18.4300.1002 = STRING: "25"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.18.4300.1003 = STRING: "40"
|
|
SNMPv2-SMI::enterprises.29385.106.1.2.18.4300.1012 = STRING: "80"
|
|
|
|
- Get total sessions count (field: 7) in frontend (type: 1), sid.iid: 47.0 (proxy #47):
|
|
snmpget -c public -v2c 192.168.0.1 enterprises.29385.106.1.0.7.47.0
|
|
SNMPv2-SMI::enterprises.29385.106.1.0.7.47.0 = STRING: "1014019"
|
|
|
|
- Get a list of available variables (req: 0):
|
|
$ snmpbulkwalk -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.2.0
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.0 = STRING: "Name"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.1 = STRING: "Version"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.2 = STRING: "Release_date"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.3 = STRING: "Nbproc"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.4 = STRING: "Process_num"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.5 = STRING: "Pid"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.6 = STRING: "Uptime"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.7 = STRING: "Uptime_sec"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.8 = STRING: "Memmax_MB"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.9 = STRING: "Ulimit-n"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.10 = STRING: "Maxsock"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.11 = STRING: "Maxconn"
|
|
SNMPv2-SMI::enterprises.29385.106.2.0.12 = STRING: "CurrConns"
|
|
|
|
- Get a variable (req: 1), varnr: 7 (Uptime_sec):
|
|
$ snmpget -c public -v2c 192.168.0.1 1.3.6.1.4.1.29385.106.2.1.7
|
|
SNMPv2-SMI::enterprises.29385.106.2.1.7 = STRING: "18761"
|
|
|