fritznagios

Nagios/Icinga monitoring check program for FRITZ!Box devices, based on fritzconnection.

Fritznagios

Status License PyPI Python versions Downloads

About

Nagios/Icinga monitoring check program for FRITZ!Box devices based on the excellent fritzconnection module for maximum device coverage. It uses the TR-064 protocol over UPnP.

Icinga Exchange: https://exchange.icinga.com/tonke/fritznagios

Setup

python3 -m venv /opt/fritznagios

# Install latest stable version.
/opt/fritznagios/bin/pip install fritznagios

# Install from repository.
/opt/fritznagios/bin/pip install git+https://github.com/cicerops/fritznagios

Usage

/opt/fritznagios/bin/fritznagios --help

Icinga 2

For integrating the check program into Icinga 2, you can use the configuration files in the icinga2 subdirectory. You can easily acquire the files using:

wget https://raw.githubusercontent.com/cicerops/fritznagios/main/icinga2/fritznagios-command.conf
wget https://raw.githubusercontent.com/cicerops/fritznagios/main/icinga2/fritznagios-services.conf
wget https://raw.githubusercontent.com/cicerops/fritznagios/main/icinga2/fritznagios-host.conf

Development

Acquire sources:

git clone https://github.com/cicerops/fritznagios
cd fritznagios

Install program in development mode:

python3 -m venv .venv
source .venv/bin/activate
pip install --editable=.

Build and upload sdist package to PyPI:

python setup.py sdist
pip install twine
twine upload --skip-existing dist/*