Check OpenLDAP cn=monitor information

Presentation

This Nagios plugin gets different information from OpenLDAP cn=monitor backend like:

• Current connections
• Total connections
• LDAP operations
• BDB backend caches
• MDB used and free pages

With performance data, it allows to create graph to follow evolution of these indicators.

Configuration

Required Perl modules:

• Net::LDAP
• Getopt::Std
• File::Basename

Usage

$ perl check_ldap_monitor.pl -T type -H hostname [-p port] [-D binddn -P bindpw] [-m mode]

Mandatory Options

-H	LDAP server hostname or IP, or LDAP URI
-w	Warning threshold
-c	Critical threshold
-T	Type of information to check: currentconnections: current established connections totalconnections: total established connections dncache: total DN in cache entrycache: total entries in cache idlcache: total IDL in cache totaloperations: total operations totalabandon: total ABANDON operation totaladd: total ADD operations totalbind: total BIND operations totalcompare: total COMPARE operations totaldelete: total DELETE operations totalextended: total EXTENDED operations totalmodify: total MODIFY operations totalmodrdn: total MODRDN operations totalsearch: total SEARCH operations totalunbind: total UNBIND operations mdbpagesmax: maximum pages in MDB database (see check lmdb usage plugin) mdbpagesused: used pages in MDB database (see check lmdb usage plugin) mdbpagesfree: free pages in MDB database (see check lmdb usage plugin) mdbpagesusedrelative: percentage of used pages in MDB database (see check lmdb usage plugin) mdbpagesfreerelative: percentage of free pages in MDB database (see check lmdb usage plugin)

Other options

-p	LDAP server port (not working if LDAP URI is set in -H)
-D	Bind DN
-P	Bind password
-v	Verbose
-V	Print version and exit
-h	Print help and exit
-f	Performance data
-t	Timeout
-F	Filter of the LDAP search
-s	Scope of the LDAP search
-b	Base of the LDAP search
-m	Mode (default: lesser): lesser: error is returned if found value is inferior to warning or critical level greater: error is returned if found value is superior to warning or critical level

Download

This plugin, along with all other Nagios plugins from this site, can be downloaded in a single archive.

For example:

$ perl check_ldap_monitor.pl -H 'ldap+tls://ldap.example.org' -D 'cn=monitor' -P 'secret' -b "cn=monitor" -T mdbpagesfreerelative -w 20 -c 10 -m lesser
OK - 34.375 percent of free pages in MDB database returned