mirror of
https://github.com/eworm-de/routeros-scripts
synced 2024-05-14 08:04:19 +00:00
64ff7fcf65
That should make the documentation clearer if external sites link to the documentation of a specific script.
59 lines
2 KiB
Markdown
59 lines
2 KiB
Markdown
Notify on host up and down
|
|
==========================
|
|
|
|
[◀ Go back to main README](../README.md)
|
|
|
|
🛈 This script can not be used on its own but requires the base installation.
|
|
See [main README](../README.md) for details.
|
|
|
|
Description
|
|
-----------
|
|
|
|
This script sends notifications about host UP and DOWN events. In comparison
|
|
to just netwatch (`/ tool netwatch`) and its `up-script` and `down-script`
|
|
this script implements a simple state machine and dependency model. Host
|
|
down events are triggered only if the host is down for several checks and
|
|
optional parent host is not down to avoid false alerts.
|
|
|
|
Requirements and installation
|
|
-----------------------------
|
|
|
|
Just install the script:
|
|
|
|
$ScriptInstallUpdate netwatch-notify;
|
|
|
|
Then add a scheduler to run it periodically:
|
|
|
|
/ system scheduler add interval=1m name=netwatch-notify on-event="/ system script run netwatch-notify;" start-time=startup;
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The hosts to be checked have to be added to netwatch with specific comment:
|
|
|
|
/ tool netwatch add comment="notify, hostname=example.com" host=[ :resolve "example.com" ];
|
|
|
|
It is possible to run an up hook command (`up-hook`) or down hook command
|
|
(`down-hook`) when a notification is triggered. This has to be added in
|
|
comment:
|
|
|
|
/ tool netwatch add comment="notify, hostname=poe-device, down-hook=/ interface ethernet poe power-cycle en21;" host=10.0.0.20;
|
|
|
|
The count threshould (default is 5 checks) is configurable as well:
|
|
|
|
/ tool netwatch add comment="notify, hostname=example.com, count=10" host=104.18.144.11;
|
|
|
|
If the host is behind another checked host add a dependency, this will
|
|
suppress notification if the parent host is down:
|
|
|
|
/ tool netwatch add comment="notify, hostname=gateway" host=93.184.216.1;
|
|
/ tool netwatch add comment="notify, hostname=example.com, parent=gateway" host=93.184.216.34;
|
|
|
|
Note that every configured parent in a chain increases the check count
|
|
threshould by one.
|
|
|
|
Also notification settings are required for e-mail and telegram.
|
|
|
|
---
|
|
[◀ Go back to main README](../README.md)
|
|
[▲ Go back to top](#top)
|