check_brandmeister

Crates.iocheck_brandmeister
lib.rscheck_brandmeister
version0.2.4
sourcesrc
created_at2021-11-19 14:19:48.648326
updated_at2021-12-09 20:35:37.08473
descriptionNagios plugin to check online status of a BrandMeister repeater.
homepagehttps://github.com/sgrimee/check_brandmeister
repositoryhttps://github.com/sgrimee/check_brandmeister
max_upload_size
id484472
size23,273
Sam Grimee - LX2SG (sgrimee)

documentation

https://docs.rs/crate/check_brandmeister/latest

README

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

Commit count: 23

cargo fmt