check-jitter 0.2.17

A Nagios compatible plugin to measure network jitter.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# check_jitter

[![crates.io](https://img.shields.io/crates/v/check-jitter.svg)](https://crates.io/crates/check-jitter)
[![Documentation](https://docs.rs/check-jitter/badge.svg)](https://docs.rs/check-jitter)
[![ISC licensed](https://img.shields.io/crates/l/check-jitter.svg)](./LICENSE)

This plugin will measure network jitter by sending a number of ICMP pings to a
host and calculate the average jitter based on the differences between
consecutive round trip times.

## Help Text

``` sh
check_jitter - A Nagios compatible plugin that measures network jitter.

SAMPLE INTERVALS

When -m and -M are both set to 0, the plugin will send pings immediately after
receiving a response.

When -m and -M are set to the same value, the plugin will send pings at a fixed
interval.

When -m and -M are set to different values, the plugin will send pings at random
intervals between the two values.

-m must be less than or equal to -M.

THRESHOLD SYNTAX

Thresholds are defined using Nagios range syntax.

Example ranges:
+------------------+-------------------------------------------------+
| Range definition | Generate an alert if x...                       |
+------------------+-------------------------------------------------+
| 10               | < 0 or > 10, (outside the range of {0 .. 10})   |
+------------------+-------------------------------------------------+
| 10:              | < 10, (outside {10 .. ∞})                       |
+------------------+-------------------------------------------------+
| ~:10             | > 10, (outside the range of {-∞ .. 10})         |
+------------------+-------------------------------------------------+
| 10:20            | < 10 or > 20, (outside the range of {10 .. 20}) |
+------------------+-------------------------------------------------+
| @10:20           | ≥ 10 and ≤ 20, (inside the range of {10 .. 20}) |
+------------------+-------------------------------------------------+

Usage: check_jitter [OPTIONS] --host <HOST>

Options:
  -c, --critical <CRITICAL>          Critical limit for network jitter in milliseconds
  -d, --debug                        Enable debug logging
  -H, --host <HOST>                  Hostname or IP address to ping
  -m, --min-interval <MIN_INTERVAL>  Minimum interval between ping samples in milliseconds [default: 0]
  -M, --max-interval <MAX_INTERVAL>  Maximum interval between ping samples in milliseconds [default: 0]
  -p, --precision <PRECISION>        Precision of the output decimal places [default: 3]
  -s, --samples <SAMPLES>            Number of pings to send [default: 10]
  -t, --timeout <TIMEOUT>            Timeout in milliseconds per individual ping check [default: 1000]
  -w, --warning <WARNING>            Warning limit for network jitter in milliseconds
  -h, --help                         Print help
  -V, --version                      Print version
```

## Installation

Download the latest Linux or Windows binary from [the latest release
page](https://github.com/johanthoren/check_jitter/releases/latest).

Use together with NRPE or similar, preferably with
[Opsview](https://www.itrsgroup.com/products/infrastructure-monitoring).

Note that the plugin requires elevated permissions, so you will have to use
`setuid` or similar.

## License

Copyright © 2024 Johan Thorén <johan@thoren.xyz>

This project is released under the ISC license. See the LICENSE file for more
details.