Nagios plugin to check SL delays for a given site
check_sl_delay is a simple Nagios plugins to check the percentage of late departures for any given site operated by SL (Stockholms Länstrafik).
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.
# 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.
Wherever your executable file has been placed, you may symlink it to a place where plugins are generally available in your environment, for example
# ln -s /usr/local/bin/check_sl_delay /opt/plugins/check_sl_delay
Once you have made sure that check_sl_delay is on your $PATH, you can find some useful information with the
$ 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 and the needed API key can be found using the API SL Platsuppslag: https://www.trafiklab.se/api/sl-platsuppslag/dokumentation The departure-api-key can be found using the API SL Realtidsinformation 4: https://www.trafiklab.se/api/sl-realtidsdokumentation-4/dokumentation Example: check_sl_delay -a <site-api-key> -A <departure-api-key> -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: -a, --site-api-key TEXT API key for 'SL Platsuppslag' (see trafiklab.se) [required] -A, --departure-api-key TEXT API key for 'SL Realtidsinformation 4' (see trafiklab.se) [required] -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. -i, --site-id INTEGER RANGE Site-id to check. [required] -m, --minutes INTEGER RANGE Delay threshold, in minutes. [required] -p, --period INTEGER Time period to check, in minutes. [required] -t, --timeout INTEGER RANGE Plugin timeout, in seconds. -T, --traffic-type [BUS|METRO|TRAIN] Traffic type to check. [required] -v, --verbose Use 2 times for higher verbosity. --version Show the version and exit. -h, --help Show this message and exit.
Due to a limitation in click the locale must be unicode and not ascii. For more information see this page.
- Added options for API key and removed personal key from dev files.
- Minor fixes.
- Added short help option (-h).
- First stable release on PyPI.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for check_sl_delay-0.1.3-py3-none-any.whl