#amateur-radio

bin+lib check_brandmeister

Nagios plugin to check online status of a BrandMeister repeater

4 releases

0.2.4 Dec 9, 2021
0.2.3 Dec 9, 2021
0.2.0 Dec 9, 2021
0.1.1 Dec 7, 2021
0.1.0 Nov 19, 2021

#15 in #amateur-radio

MIT license

11KB
89 lines

check_brandmeister

Simple plugin for nagios-compatible monitoring systems to check ham-radio repeater status on the BrandMeister network.

It verifies the last time a ham-radio repeater was seen on the BrandMeister network using BrandMeister's API and compares the number of seconds elapsed to thresholds for Warning or Critical state. Tested with LibreNMS.

Crates.io GitHub release Crates.io Build Status

Installation

Build the executable and install it in your nagios plugin folder.

Example:

cargo install check_brandmeister
sudo mv $HOME/.cargo/bin /usr/lib/nagios/plugins/

If you do not want to compile, you may find pre-built binaries on the releases page

Usage

The check_brandmeister plugin is called by Nagios or LibreNMS but can be tested on the command-line.

Example:

check_brandmeister --repeater 270107 --critical 900

BrandMeister repeater 270107 is OK: online status| 'last_seen'=152s;;900;0;
USAGE:
    check_brandmeister [OPTIONS] --repeater <repeater>

OPTIONS:
    -c, --critical <seconds>
            Optional: Inactive time in seconds before Critical state

    -h, --help
            Print help information

    -H, --host <host>
            Optional and ignored. For compatibility with nagios Host

    -r, --repeater <id>
            BM repeater id, e.g. 270107

    -V, --version
            Print version information

    -w, --warning <seconds>
            Optional: Inactive time in seconds before Warning state

License: MIT

Dependencies

~5.5–7.5MB
~126K SLoC