Nagios plugin for monitoring Keepalived via SNMP
Switch branches/tags
Nothing to show
Clone or download
Latest commit 9547f46 May 11, 2016
Permalink
Failed to load latest commit information.
COPYING Adding license information. May 10, 2016
README.md Create README.md May 10, 2016
check_keepalived_ipvs.pl Updating versions. May 10, 2016
check_keepalived_vrrp.pl Updating versions. May 10, 2016

README.md

Nagios Check Keepalived

Nagios plugins for monitoring Keepalived VRRP and IPVS subsystems via SNMP. This package contains the following Nagios checks:

  • check_keepalived_vrrp.pl - Checks VRRP subsystem
  • check_keepalived_ipvs.pl - Checks IPVS subsystem

Script Usage

check_keepalived_ipvs.pl:

    Usage: check_keepalived_ipvs.pl [OPTIONS]
    OPTIONS:
      -a agent        SNMP agent address
      -c community    SNMP community string
      -e count        CRIT, if more than count servers are down
      -E percent      CRIT, if percentage of servers is below percent
      -h              display this message
      -n pattern      include virtual servers matching pattern
      -Q              ignore quorum if not met
      -q              quiet output
      -t              display terse details
      -V              display program version
      -v version      SNMP version
      -w count        WARN, if more than count servers are down
      -W percent      WARN, if percentage of servers is below percent
      -x pattern      exclude virtual servers matching pattern

check_keepalived_vrrp.pl:

    Usage: check_keepalived_vrrp.pl [OPTIONS]
    OPTIONS:
      -a agent        SNMP agent address
      -b              verify VRRP instance is backup
      -c community    SNMP community string
      -m              verify VRRP instance is master
      -n name         VRRP instance name
      -h              display this message
      -q              quiet output
      -t              display terse details
      -V              display program version
      -v version      SNMP version
      -w weight       weight threshold of master instance
      -x pattern      exclude virtual routers matching pattern

Example Output (IPVS)

    syzdek@nagios$ /usr/libexec/nagios/check_keepalived_ipvs.pl -a dnslvs1.example.com -c public
    Virtual Servers: 2 OKAY - Keepalived v1.2.19 (04/19,2016)|
    -
    Router ID:     dnslvs1.example.com
    IPVS Count:    2
    -
    IPVS fwmark:153 (udp) (OKAY)
    IP Virtual Server:    fwmark wrr dr
    Capacity:             7 of 7 (100%) real servers up
    Quorum Weights:       quorum met, min: 1, recovery: 0, current: 70
    Active Connections:   0 connections, 0 connections/s
    Bytes In:             0 bytes, 0 bytes/s
    Bytes Out:            0 bytes, 0 bytes/s
    Packets In:           0 packets, 0 packets/s
    Packets Out:          0 packets, 0 packets/s
    Real Server:          [2001:4948:f:53::130]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::131]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::132]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::133]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::134]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::135]:0 (alive), 10 weight, 0 connections, 0 connections/s
    Real Server:          [2001:4948:f:53::136]:0 (alive), 10 weight, 0 connections, 0 connections/s
    -
    IPVS fwmark:53 (udp) (OKAY)
    IP Virtual Server:    fwmark wrr dr
    Capacity:             7 of 7 (100%) real servers up
    Quorum Weights:       quorum met, min: 1, recovery: 0, current: 70
    Active Connections:   1116330524 connections, 1095 connections/s
    Bytes In:             108151191577 bytes, 102498 bytes/s
    Bytes Out:            0 bytes, 0 bytes/s
    Packets In:           1537688411 packets, 1462 packets/s
    Packets Out:          0 packets, 0 packets/s
    Real Server:          216.67.109.130:0 (alive), 10 weight, 0 connections, 156 connections/s
    Real Server:          216.67.109.131:0 (alive), 10 weight, 2 connections, 156 connections/s
    Real Server:          216.67.109.132:0 (alive), 10 weight, 0 connections, 156 connections/s
    Real Server:          216.67.109.133:0 (alive), 10 weight, 0 connections, 156 connections/s
    Real Server:          216.67.109.134:0 (alive), 10 weight, 1 connections, 156 connections/s
    Real Server:          216.67.109.135:0 (alive), 10 weight, 1 connections, 156 connections/s
    Real Server:          216.67.109.136:0 (alive), 10 weight, 0 connections, 156 connections/s
    |
    syzdek@nagios$

Example Output (VRRP)

   syzdek@nagios$ /usr/libexec/nagios/check_keepalived_vrrp.pl -a dnslvs1.example.com -c public
    Virtual Routers: 2 OKAY - Keepalived v1.2.19 (04/19,2016)|
    -
    Router ID:     dnslvs1.example.com
    Check Method:  by initial/current states
    vRouter Count: 2
    -
    dnsvrrp20.nwc (OKAY)
    Virtual Router ID:    20
    State (current):      master
    State (desired)::     master
    State (initial):      master
    Weight (base):        100
    Weight (effective):   100
    Virtual IP Address:   216.67.109.140 (set)
    Virtual IP Address:   [2001:4948:f:53::140] (set)
    Virtual IP Status:    allSet
    Primary Interface:    eth1.2009
    LVS Sync Daemon:      disabled
    -
    dnsvrrp21.nwc (OKAY)
    Virtual Router ID:    21
    State (current):      backup
    State (desired)::     backup
    State (initial):      backup
    Weight (base):        25
    Weight (effective):   25
    Virtual IP Address:   216.67.109.141 (unset)
    Virtual IP Status:    notAllSet
    Primary Interface:    eth1.2009
    LVS Sync Daemon:      disabled
    |
    syzdek@nagios$

Example Nagios Configurations (Command Objects)

Example command object configurations for VRRP:

    # VRRP desired state is determined by initial state
    define command{
       command_name    check_keepalived_vrrp
       command_line    $USER1$/check_keepalived_vrrp.pl -c public -a $HOSTADDRESS$
    }
    
    # VRRP desired state is determined by effective weight
    # In this example, a master has an effective weight of 10 or more
    define command{
       command_name    check_keepalived_vrrp_by_weight
       command_line    $USER1$/check_keepalived_vrrp.pl -c public -a $HOSTADDRESS$  -w 10
    }

    # VRRP desired state is hardcoded
    define command{
       command_name    check_keepalived_vrrp_master
       command_line    $USER1$/check_keepalived_vrrp.pl -c public -a $HOSTADDRESS$ -m
    }
    define command{
       command_name    check_keepalived_vrrp_backup
       command_line    $USER1$/check_keepalived_vrrp.pl-c public -a $HOSTADDRESS$ -b
    }

Example command object configurations for IPVS:

    # Use default paramters
    define command{
       command_name    check_keepalived_ipvs
       command_line    $USER1$/check_keepalived_ipvs.pl -c public -a $HOSTADDRESS$
    }
    
    # Warn if 2 servers are down and critical if less than 25% of the servers are up
    define command{
       command_name    check_keepalived_ipvs
       command_line    $USER1$/check_keepalived_ipvs.pl -c public -a $HOSTADDRESS$ -w 2 -C 25
    }
    
    # Warn if 25% of servers are down and critical if less than 50% of the servers are up
    # ignore quorum paramters
    define command{
       command_name    check_keepalived_ipvs
       command_line    $USER1$/check_keepalived_ipvs.pl -c public -a $HOSTADDRESS$ -W 75 -C 50 -Q
    }

By default the checks provide both the default output text and long text. If the checks are being called via NRPE, the long text can be shortened by enabling terse output with the -t option. Additionally, long text can be completely disabled by providing the '-q' option to the checks.

Example Nagios Configurations (Service Objects)

VRRP service checks:

    define service{
       use                     generic-service
       host_name               dnslvs1.example.org
       display_name            VRRP
       service_description     VRRP
       check_command           check_keepalived_vrrp
    }

IPVS service checks:

    define service{
       use                     generic-service
       host_name               dnslvs20.example.org
       display_name            IPVS
       service_description     IPVS
       check_command           check_keepalived_ipvs
    }