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 2.13 KiB
Newer Older
thl-cmk's avatar
thl-cmk committed
[PACKAGE]: ../../raw/master/mkp/ospf_neighbor-1.4.1-20230422.mkp "ospf_neighbor-1.4.1-20230422.mkp"
thl-cmk's avatar
thl-cmk committed
# OSPF neighbors
thl-cmk's avatar
thl-cmk committed

Monitors status of OSPF neighbors.

thl-cmk's avatar
thl-cmk committed
---
thl-cmk's avatar
thl-cmk committed
### Acknowledgment 
thl-cmk's avatar
thl-cmk committed
This check is based on [OSPF Neighbor State Check](https://exchange.checkmk.com/p/ospf-neighbor) by Thomas Wollner (tw[at]wollner-net[dot]de).
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
I changed the *item* from neighbor **ID** to neighbor **IP**, added events as perfdata (incl. metrics file),\
thl-cmk's avatar
thl-cmk committed
moved part of the output to long output and done a little code cleanup to better match coding guide lines.\
Added WATO for Alias name, map check states to OSPF Neighbor state, state if neighbour not found in SNMP data.
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
---
### Check Info:
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *service*: ithe check creates one service for each OSPF neighbor with the neighbor IP as item
thl-cmk's avatar
thl-cmk committed
* *state*: 
    * **critical** if the neighbor state is *down*
    * **warning** if the neighbor is not in *full* or *2-way* state
    * **unknown** if the agent output is invalid
thl-cmk's avatar
thl-cmk committed
* *wato*: 
thl-cmk's avatar
thl-cmk committed
    * default monitoring state if neighbor not found in SNMP data
    * configure monitoring state for the different OSPF neighbor states
thl-cmk's avatar
thl-cmk committed
    * configure a alias for each OSPF neighbor
thl-cmk's avatar
thl-cmk committed
    * configure the monitoring state if the OSPF neighbor is not found in the SNMP data
thl-cmk's avatar
thl-cmk committed
* *perfdata*:
    * OSPF neighbor events (count)
    * Retransmission queue length (count)
thl-cmk's avatar
thl-cmk committed

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

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

thl-cmk's avatar
thl-cmk committed
**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

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

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

---
thl-cmk's avatar
thl-cmk committed
### Want to contribute?

thl-cmk's avatar
thl-cmk committed
Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")

---
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.png?raw=true "sample output")
thl-cmk's avatar
thl-cmk committed

WATO options
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
![WATO options](img/wato.png?raw=true "WATO options")