Skip to content

Nagios plugin to track online status of BrandMeister ham-radio repeaters

License

Notifications You must be signed in to change notification settings

sgrimee/check_brandmeister

Repository files navigation

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

About

Nagios plugin to track online status of BrandMeister ham-radio repeaters

Resources

License

Stars

Watchers

Forks

Packages

No packages published