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.09 KiB
Newer Older
thl-cmk's avatar
thl-cmk committed
[PACKAGE]: ../../raw/master/mkp/active_check_traceroute-0.0.3-20240526.mkp "active_check_traceroute-0.0.3-20240526.mkp"
thl-cmk's avatar
thl-cmk committed
# Extended traceroute plugin
thl-cmk's avatar
thl-cmk committed

This is a extension for the original CheckMK traceroute plugin (Routing)

thl-cmk's avatar
thl-cmk committed
adds the following options:
thl-cmk's avatar
thl-cmk committed

- service description suffix
- alternate destination address
thl-cmk's avatar
thl-cmk committed
- UDP method (without increasing the port for each probe)
thl-cmk's avatar
thl-cmk committed
- destination port for UDP/TCP path trace
- max hops
- queries per hop
- source address
- source interface (needs root permissions)
- perfometer

thl-cmk's avatar
thl-cmk committed
**Note: Source address and source interface uses the "shell=True" option in in the "subprocess.Popen" command. This is insecure, so be careful.**

thl-cmk's avatar
thl-cmk committed
To enable this options you need to uncomment the line `# shell = True` in [~/lib/nagios/plugins/check_traceroute](https://thl-cmk.hopto.org/gitlab/checkmk/vendor-independent/active_check_traceroute/-/blob/master/lib/nagios/plugins/check_traceroute) like this.
thl-cmk's avatar
thl-cmk committed

```
    if (source_int is not None) or (source_addr is not None):
        cmd = ' '.join(cmd)
thl-cmk's avatar
thl-cmk committed
        shell = True
thl-cmk's avatar
thl-cmk committed

```
thl-cmk's avatar
thl-cmk committed

**Note**: the original TCP path trace option also needs root permisions.
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*: creates the service **_Routing {item}_** with optional suffix as item
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *state*: see original plugin
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *wato*: [(see WATO options)](/../../../-/raw/master/doc/wato.png "see sample screenshot")
thl-cmk's avatar
thl-cmk committed

thl-cmk's avatar
thl-cmk committed
* *perfdata*: see original plugin
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

You can install the package by uploading it to your CheckMK site and as site user run `mkp install active_check_traceroute.mkp`.


In the Enterprise/Free edition of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)

---
### Want to contribute?

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

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

WATO

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