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:

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