About:

getsnmp is a scheduler for collect snmp values from any network equipment and store it into a rrdtool database.

News:

version 0.11: (12/02/2009)
FEAT: can use 64 bit counters
FEAT: permit to specify global data filename. this is new inherited value
FEAT: increase error log verbosity
FEAT: dont quit program if select return an error. try to resolve error.
FEAT: log warning if negative timeout is encoutered
CLEANUP: code reorganization
CLEANUP: normalize comments
CLEANUP: remove unused debug info
BUG: major: fix scheduler loop bug. When getsnmp do send at least two snmp request at the same hosts, and this does not respond, the snmp timeout cause bug in scheduler.
BUG: minor: check for microseconds overflow (> 1000000) after adding 2 dates
BUG: minor: fix bug into negative time detection
BUG: minor: log real getsnmp version
BUG: minor: error in rotate value interpretation
BUG: minor: bug in displaying rotate filenames
BUG: minor: Use defines around rrd initialization string. this initialization is not necessary if rrdtool is not compiled in
BUG: minor: twice buffer initialization
version 0.10: (06/02/2009)
can display expanded conf ( -s )
BUGFIX: memory crush
version 0.9: (09/09/2008)
By Lucian Craciun: FreeBSD bug in the sheduler
version 0.8: (20/02/2008)
can add specific mib directorys
log in all cases
minor bug: segfault in some cases when loading configuration
version 0.7: (01/05/2008)
permit rotation when the filename is in the get section
version 0.6: (17/12/2007)
can add specific mib directorys
log in all cases
permit rotation when the filename is in the get section
minor bug: segfault in some cases when loading configuration
version 0.6: (17/12/2007)
extend configuration file possibilities for making this more simply
version 0.5: (03/12/2007)
Prevent segfault in error log
version 0.4: (01/12/2007)
OpenBSD port
data files rotation
can add a global data filename prefix
limit number of oids requested in one paquet snmp
Segfault when the conf is parsed if DNS resolution failed.
use unsigned int in file values
dont quit in error case
generate warning when parse config file
Doc
version 0.3: (04/05/2007)
the snmp values can be stored in a log file
you can compile the project without rrdtool
bug in install script
version 0.2: (25/04/2007)
error while reading config file
version 0.1b (beta): (06/02/2007)
init db files after chrooting
implement basic -h option command line
man writted
version 0.0b (beta): (05/02/2007)
initial release

Doc (0.11):

global config section:

COMMAND LINE

-h help

Comma separated network interfaces listen to.

-f config_file

Specify the config file.

-D log level required

-d run as daemon

-v version

CONFIG FILE

directorydb <directory>: store rrdtool db files into this directory
lockfile <pidfile>: file used for store pid number and lock the process
daemon (yes|no): run in daemon mode (fork) ?
umask umask: mask creation file
user user: user running application
chrootdir <path>: directory to chroot application
loglevel (0|1|2|3|4|5|6|7): log with this level
0: emergency
1: alert
2: critical
3: error
4: warning
5: notice
6: info
7: debug
usesyslog (yes|no): use syslog
logfile <logfile>: log in this file
max_oid_in_one_request 0..n: limit the number of oid requested in one request snmp a big number of oid requested not contain in one udp paquet
the default is 30

retrieve data section:

global community community

set the default community
the default unsetted is 'public'

global inter seconds

set the default interval among two snmp get
the default unsetted is '300'

global retry number

set the default number of retry
the default unsetted is '0'

global timeout seconds

set the default request timeout (in seconds)
the default unsetted is '3'

global version (v1|v2|v2c)

set the default snmp protocol version
the default value unsetted is 'v1'

global backends (rrd|file)

set the defaults backends for recording values. the default is rrd only.

global rotate (no|seconds 0..n)

rotate file time ("no" for disabled) default no

global prefix string

prefix data file default ""

global filename string

set default data file no default

set

the keyword "set" set a snmp host server:

example:
set version v2c ip 192.168.10.4 timeout 3 retry 2 community public

the option are:

* ip	server ip (must informed)
inter	interval among two snmp get (default: "global inter")
version	snmp protocol version (default: "global version")
timeout	request timeout (default: "global timeout")
retry	number of retry (default: "global retry")
community	community (default: "global community")
backend_rrd	default rrd backend (default: "global backends")
backend_file	default file backend (default: "global backends")
rotate	set rotation system time ("no" for disabled) (default: "global rotate")
prefix	set prefix for data file (default: "global prefix")
filename	the snmp values file (default: "global filename")

( * ) must informed

get

the "get" keyword is used for declaring one snmp value:

example:
get oid IF-MIB::ifInOctets.3 inter 5 file toto type gauge

the option are:

* oid SNMPv2-MIB::sysDescr.0	the oid name. For making configuration easy, the OID name can be extended. Ex: IF-MIB::if{In,Out}{Octets,Errors}.{1-24}. the parameters filaname, dataname and file can be match this variables with this syntax , , ... (this parameter must informed)
inter	interval among two snmp get (default: inherited from the last set)
file	the db rrdtool file (default: automaticaly generated from OID)
filename	the snmp values file (default: automaticaly generated from OID)
dataname	the name of the data getted (default: automaticaly generated from OID)
type gauge	type of rrdtool data (gauge, counter) (default: gauge)
timeout	request timeout (default: inherited from the last set)
retry	number of retry (default: inherited from the last set)
backend_rrd	default rrd backend (default: inherited from the last set)
backend_file	default file backend (default: inherited from the last set)
rotate	set rotation system time ("no" for disabled) (default: inherited from the last set)
prefix	set prefix for data file (default: inherited from the last set)
filename	the snmp values file (default: inherited from the last set if no filename inherited, is automaticaly generated)

( * ) must informed

examples:

###################################################
# router
###################################################
set ip 192.168.10.1
# vlan0
get oid IF-MIB::ifInOctets.3 type counter
get oid IF-MIB::ifOutOctets.3 type counter
# vlan1
get oid IF-MIB::ifInOctets.4 type counter
get oid IF-MIB::ifOutOctets.4 type counter
# vlan2
get oid IF-MIB::ifInOctets.5 type counter
get oid IF-MIB::ifOutOctets.5 type counter
# tun0
get oid IF-MIB::ifInOctets.7 type counter
get oid IF-MIB::ifOutOctets.7 type counter
# tun1
get oid IF-MIB::ifInOctets.6 type counter
get oid IF-MIB::ifOutOctets.6 type counter
# cpu user / nice / system
get oid UCD-SNMP-MIB::ssCpuRawUser.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawNice.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawSystem.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawIdle.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawKernel.0 type counter
# mem
get oid UCD-SNMP-MIB::memTotalReal.0 type gauge
get oid UCD-SNMP-MIB::memAvailReal.0 type gauge
get oid UCD-SNMP-MIB::memCached.0 type gauge


###################################################
# server
###################################################
set ip 192.168.10.2
get oid IF-MIB::ifInOctets.2 type counter
get oid IF-MIB::ifOutOctets.2 type counter
# cpu user / nice / system
get oid UCD-SNMP-MIB::ssCpuRawUser.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawNice.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawSystem.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawIdle.0 type counter
get oid UCD-SNMP-MIB::ssCpuRawKernel.0 type counter
# mem
get oid UCD-SNMP-MIB::memTotalReal.0 type gauge
get oid UCD-SNMP-MIB::memAvailReal.0 type gauge
get oid UCD-SNMP-MIB::memCached.0 type gauge
# disque
get oid HOST-RESOURCES-MIB::hrStorageUsed.7 type gauge

Downloads:

File	MD5Sum
getsnmp-0.11.tar.gz	`2b28cab1a112bf884c003a12c756dd9f`
getsnmp-0.10.tar.gz	`- Availaible on demand -`
getsnmp-0.9.tar.gz	`- Availaible on demand -`
getsnmp-0.8.tar.gz	`- Availaible on demand -`
getsnmp-0.7.tar.gz	`- Availaible on demand -`
getsnmp-0.6.tar.gz	`- Availaible on demand -`
getsnmp-0.5.tar.gz	`- Availaible on demand -`
getsnmp-0.4.tar.gz	`- Availaible on demand -`
getsnmp-0.3.tar.gz	`- Availaible on demand -`
getsnmp-0.2.tar.gz	`- Availaible on demand -`
getsnmp-0.1b.tar.gz	`- Availaible on demand -`
getsnmp-0.0b.tar.gz	`- Availaible on demand -`

Contact

Author: Thierry FOURNIER
EMail: