https://github.com/cicerops/fritznagios

Nagios/Icinga monitoring check program for FRITZ!Box devices, based on fritzconnection.
https://github.com/cicerops/fritznagios

avm fritz-box fritzbox icinga icinga-plugin icinga-plugins icinga2 icinga2-plugin icinga2-plugins lte nagios nagios-plugin nagios-plugins

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/cicerops/fritznagios
• Owner: cicerops
• License: mit
• Created: 2022-03-02T15:10:42.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-03-30T22:28:29.000Z (almost 3 years ago)
• Last Synced: 2024-08-09T16:21:26.197Z (5 months ago)
• Topics: avm, fritz-box, fritzbox, icinga, icinga-plugin, icinga-plugins, icinga2, icinga2-plugin, icinga2-plugins, lte, nagios, nagios-plugin, nagios-plugins
• Language: Python
• Homepage:
• Size: 25.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Fritznagios

[![Status](https://img.shields.io/pypi/status/fritznagios.svg?style=flat-square)](https://pypi.org/project/fritznagios/)

[![License](https://img.shields.io/github/license/cicerops/fritznagios.svg?style=flat-square)](https://github.com/cicerops/fritznagios/blob/main/LICENSE)

[![PyPI](https://img.shields.io/pypi/v/fritznagios.svg?style=flat-square)](https://pypi.org/project/fritznagios/)

[![Python versions](https://img.shields.io/pypi/pyversions/fritznagios.svg?style=flat-square)](https://pypi.org/project/fritznagios/)

[![Downloads](https://img.shields.io/pypi/dm/fritznagios.svg?style=flat-square)](https://pypi.org/project/fritznagios/)

## 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

[fritzconnection]: https://github.com/kbr/fritzconnection

[UPnP]: https://en.wikipedia.org/wiki/Universal_Plug_and_Play

## 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/*