Nagios plugin to check SL delays for a given site
Project description
check_sl_delay
Introduction
check_sl_delay is a simple Nagios plugins to check the percentage of late departures for any given site.
Installation
The easiest way to install check_sl_delay is via pip. Make sure to run this with python3, in some environments pip should be replaced with pip3 or similar.
For a specific user:
$ pip install --user check-sl-delay
This will put the executable check_sl_delay in ~/.local/bin/, so make sure that this is part of your $PATH variable.
System wide:
# pip install check-sl-delay
This will put the executable check_sl_delay in /usr/local/bin/, which is usually already part of the system wide $PATH. Check the documentation of your specific OS.
Usage
Once you have made sure that check_sl_delay is on your $PATH, you can find some useful information with the --help
option:
$ check_sl_delay --help
Usage: check_sl_delay [OPTIONS]
check_sl_delay will connect to the SL API to determine the percentage of
delayed departures for any given site-id.
The site-id can be found using the API SL Platsuppslag:
https://www.trafiklab.se/api/sl-platsuppslag/dokumentation
Example: check_sl_delay -p 10 -m 1 -i 1002 -T METRO -w 20 -c 30
The above example will check the site 1002 (T-Centralen) for all METRO
departures in the coming 10 minutes. It will warn if the percentage of
departures that are more than 1 minute late is 20% or more of the total
amount of departures for the time period. It will crit if the same
percentage is 30% or more.
Options:
-w, --warning INTEGER RANGE Warning threshold (0-100), warning if the
percentage of departures having delays above
--minutes is greater or equal than this
option. Must be less than --critical.
-c, --critical INTEGER RANGE Critical threshold (0-100), critical if the
percentage of departures having delays above
--minutes is greater or equal than this
option. Must be greater than --warning.
-p, --period INTEGER Time period to check, in minutes.
[required]
-m, --minutes INTEGER RANGE Delay threshold, in minutes. [required]
-i, --site-id INTEGER Site-id to check. [required]
-t, --timeout INTEGER RANGE Plugin timeout, in seconds.
-T, --traffic-type [BUS|METRO|TRAIN]
Traffic type to check. [required]
--help Show this message and exit
History
0.1.0-alpha.1 (2020-03-21)
- First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for check_sl_delay-0.1.0b4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9439a2dd96d3fe73f2379eb4381d984700d7b867811f9215d07e4616c3204b12 |
|
MD5 | 1dc46e60f39a77828486aaab6126e6bc |
|
BLAKE2b-256 | 8840a1752c69f1fa5d7d4d196420f7b4649cf619c80bde162f8381648a58850b |