...
Netwatch monitors the state of hosts on the network. Monitoring can be done with the following probe types:
1) ICMP - pings to a specified IP address - hosts, with an option to adjust threshold values
2) Simple - uses ping, without use of advanced metrics
3) TCP conn, to test the TCP connection
4) HTTP GET/HTTPS GET, request against a server you are monitoring
For each entry in the Netwatch table, you can specify an IP address, ping interval, and console scripts. The main advantage of Netwatch is its ability to issue arbitrary console commands on host state changes.
Info |
---|
Since 7.4, Netwatch functionality has been expanded, prior versions only support simple ICMP probes. While upgrading to the new version, old Netwatch entries will be unchanged, reporting probe type "simple" - preserving the same functionality. |
Note |
---|
Default Netwatch values are always used - even if they were not defined by the user. Make sure to check the "status" page of the probe to see if the default thresholds are appropriate for your use case. Default threshold values can be found under the "probe options" section on this page. |
Properties
Sub-menu: /tool/netwatch
Property | Description |
---|---|
host (Default:"") | The IP address of the server to be probed. Formats: - ipv4 |
type (icmp| tcp-conn|http-get|simple; Default: simple) | Type of the probe: |
interval (Default: 10s) | The time interval between probe tests |
timeout (Default: 3s) | Max time limit to wait for a response |
src-address (Default:"") | Source IP address which the Netwatch will try to use in order to reach the host. If address is not present, then the host will be considered as "down". |
start-delay (Default: 3s) | Time to wait before starting probe (on add, enable, or system start) |
startup-delay (Default: 5m) | Time to wait until starting Netwatch probe after system startup |
up-script (Default:"") | Script to execute on the event of probe state change 'fail' --> 'OK' |
down-script (Default:"") | Script to execute on the event of probe state change 'OK' --> 'fail' |
test-script (Default:"") | Script to execute at the end of every probe test |
Netwatch executes scripts as *sys user, so any defined global variable in the Netwatch script will not be readable by for an example a scheduler or other users
...
Property | Description |
---|---|
packet-interval (Default: 50ms) | The time between ICMP-request packet send |
packet-count (Default: 10) | Total count of ICMP packets to send out within a single test |
packet-size (Default: 54 (IPv4) or 54 (IPv6)) | The total size of the IP ICMP packet |
thr-rtt-max (Default: 1s) | Fail threshold for rtt-max (a value above thr-max is a probe fail) |
thr-rtt-avg (Default: 100ms) | Fail threshold for rtt-avg |
thr-rtt-stdev (Default: 250ms) | Fail threshold for rtt-stdev |
thr-rtt-jitter (Default: 1s) | Fail threshold for rtt-jitter |
thr-loss-percent (Default: 585.0%) | Fail threshold for loss-percent, default value is 85% in versions above 7.4 |
thr-loss-count (Default: 4294967295(max)) | Fail threshold for loss-count |
...
Property | Description |
---|---|
thr-tcp-conn-time (Default: 1s: 00:05...00:30) | Fail threshold for tcp-connect-time, the configuration uses microseconds, if the time unit is not specified (s/m/h), log and status pages display the same value in milliseconds. |
HTTP-GET probe pass/fail criteria
...
Property | Description |
---|---|
tcp-connect-time | time taken to establish a TCP connection |
HTTP:
Property | Description |
---|---|
http-status-code | HTTP response status code (200 OK, 404 Not Found, etc.). See mozilla-http-status or RFC7231 |
HTTPS:
Property | Description |
---|---|
http-status-code | HTTP response status code (200 OK, 404 Not Found, etc.). See mozilla-http-status or RFC7231 |
Logs
On each probe's OK/fail state change:
...