Collection of CheckMK checks (see https://checkmk.com/). All checks and plugins are provided as is. Absolutely no warranty. Send any comments to thl-cmk[at]outlook[dot]com

Skip to content
README.md 4.83 KiB
Newer Older
thl-cmk's avatar
thl-cmk committed
[PACKAGE]: ../../raw/master/mkp/cisco_eigrp-0.3.0-20230607.mkp "cisco_eigrp-0.3.0-20230607.mkp"
thl-cmk's avatar
thl-cmk committed
# Cisco EIGRP
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
Collection of Cisco EIGRP checks
thl-cmk's avatar
thl-cmk committed
*  *cisco_eigrp_as_info*: monitors the EIGRP AS status
*  *cisco_eigrp_interface*: monitors EIGRP enabled interfaces
*  *cisco_eigrp_peers*: monitors EIGRP peers (IPv4 only)
*  *cisco_eigrp_topology_table*: monitors the EIGRP topology table

thl-cmk's avatar
thl-cmk committed
---
### Download

thl-cmk's avatar
thl-cmk committed
* [Download latest mkp file][PACKAGE]

**Note**: before you update to a newer version, always check the [CHANGELOG](CHANGELOG). There might be incompatible changes.
thl-cmk's avatar
thl-cmk committed

---                   
### Installation

thl-cmk's avatar
thl-cmk committed
You can install the package by uploading it to your CheckMK site and as site user run 
```
mkp install PACKAGENAME-VERSION.mkp
```
or beginning with CMK2.2.x
```
mkp add PACKAGENAME-VERSION.mkp
mkp enable PACKAGENAME VERSION
```
In the non RAW editions of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)
thl-cmk's avatar
thl-cmk committed

---
### Want to contribute?

Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")

---
### Check Info *cisco_eigrp_as_info*
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *service*: this check creates one service per EIGRP AS and address family
thl-cmk's avatar
thl-cmk committed
* *state*: **critical** if the EIGRP AS is not found
* *wato*: none
* *perfdata*: 
    * Neighbour count (count)
    * Hellos send (/s)
    * Hellos received (/s)
    * Updates send (count)
    * Updates received (count)
    * Alternate route queries send (count)
    * Alternate route queries received (count)
    * Reply packets send (count)
    * Reply packets received (count)
    * Acknowledgements send (count)
    * Acknowledgements received (count)
    * Highest number of packets in the input queue (count)
    * Packets dropped from the input queue (count)
    * Stuck in active (SIA) queries sent (count)
    * Stuck in active (SIA) queries received (count)
    * Routes in the topology table (count)
    * Outstanding replies expected to queries send (count)

thl-cmk's avatar
thl-cmk committed
#### Sample output
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
![sample output](img/sample_as_info.png?raw=true "sample [SHORT TITLE]")
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
---
### Check Info *cisco_eigrp_interface*
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
**Note**: the item name has been chaged to short interface names (Gigabitethernet0/0/0 bocomes Gi0/0/0)

thl-cmk's avatar
thl-cmk committed
* *service*: this check creates on service per EIGRP enabled interface, EIGRP AS and address family
thl-cmk's avatar
thl-cmk committed
* *state*:\
thl-cmk's avatar
thl-cmk committed
    **critical** 
    *  if no authentication is configured on the interface
    *  if the EIGRP enabled interface is not found

    **waring** 
    *  if the EIGRP MD5 authentication configured on the interface (move to hmac-sha-256)
thl-cmk's avatar
thl-cmk committed
* *wato*:
    * you can confgure on withch interface types the check should ignore the missing EIGRP authentication
    * you can configure the check outcome for none/md5 authentication. Default is *critical* for no authentication and *warning* for MD5 based authentication
thl-cmk's avatar
thl-cmk committed
* *perfdata*:
    * Peer count (count)
    * Reliable queue length (count)
    * Unreliable queue length (count)
    * Average smooth round trip time (ms)
    * Routing updates awaiting transmission (count)
    * Reliable multicasts send (count)
    * Unreliable multicasts send (count)
    * Unreliable unicasts send (count)
    * Reliable unicasts send (count)
    * Multicast exceptions received (count)
    * Conditional-Receive packets (count)
    * Suppressed acknowledgements (count)
    * Retransmissions send (count)
    * Out-of-sequence packets received (count)
thl-cmk's avatar
thl-cmk committed
 
**Note**: Loopbak interfaces will be ommited
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
#### Sample output
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
![sample output](img/sample_interface.png?raw=true "sample [SHORT TITLE]")
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
---
### Check Info *cisco_eigrp_peers*
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *service*: this check creates on service per EOGRP peer interface, EIGRP AS and VRF (IPv4 and IPv6)
thl-cmk's avatar
thl-cmk committed
* *state*:\
    **critical** if the EIGRP peer is not found
    **warning** if the EIGRP uptime less min uptime (default 86400 seconds)
* *wato*: **min uptime**: the time befor a peer is considered as stable, the default is 86400 seconds (1 day)
* *perfdata*:
    * Peer uptime (s)
    * Packets enqueued (count)
    * Retransmissions (count)
    * Retries (count)
    * Smooth round trip time (ms)
    * Retransmission timeout (ms)

thl-cmk's avatar
thl-cmk committed
#### Sample output
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
![sample output](img/sample_peers.png?raw=true "sample [SHORT TITLE]")
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
---
### Check Info *cisco_eigrp_topology_table*
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *service*: this check creates on service per EIGRP AS, address family and VRF
thl-cmk's avatar
thl-cmk committed
* *state*:\
    **critical** if the EIGRP table is not found\
    **warning** if SIA or active routes are found 
* *wato*: you can configure if the check should ignore SIA and/or active routes
* *perfdata*:
    * All routes (count)
    * Active routes (count)
    * Stuck in active (SIA) routes (count)
    * Connected routes (count)
    * Internal routes (count)
    * External routes (count)
    * Summary routes (count)
    * Static redistributed routes (count)
    * Inet address (count)

thl-cmk's avatar
thl-cmk committed
#### Sample output
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
![sample output](img/sample_topo_table.png?raw=true "sample [SHORT TITLE]")
thl-cmk's avatar
thl-cmk committed