Skip to content
This repository was archived by the owner on Jun 6, 2025. It is now read-only.
MaximilianClemensPublic archive

About

Extended CheckMK FritzBox Agent for SmartHome Devices.

Resources

Stars

11 stars

Watchers

1 watching

Forks

Latest commit

 

History

36 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Archive State

The agent and checks have been recreated for Checkmk 2.4.0. You can find the updated version here: checkmk_fritzbox_smarthome. All further development will take place in that repository.

checkmk_fritzbox

This repository contains a additional check_MK Fritz!Box Agent which can gather informations over the AVM AHA HTTP Interface about SmartHome Devices connected to an Fritz!Box. In the first version this was a modification this was a modification of the normal checkmk fritzbox agent now it is seperated from it.
It also provides a Check for parsing the output, and WATO-Pages for configuring thresholds.

CLI Usage

./agents/special/agent_fritzbox_smarthome --help
usage: agent_fritzbox_smarthome [-h] [--debug] [--username [USERNAME]]
                                [--password [PASSWORD]] [--port [PORT]]
                                [--protocol [{http,https}]]
                                host

Check_MK Fritz!Box Smarthome Agent

positional arguments:
  host                  Host name or IP address of your Fritz!Box

optional arguments:
  -h, --help            show this help message and exit
  --debug               Debug mode: let Python exceptions come through
  --username [USERNAME]
  --password [PASSWORD]
  --port [PORT]
  --protocol [{http,https}]

Tested Devices

  • AVM FRITZ!DECT210 (FW 04.16)
    • Switching Socket
    • Function Values: powermeter, temperature, switch
  • AVM FRITZ!DECT200 (FW 04.16)
    • Switching Socket
    • Function Values: powermeter, temperature, switch
  • AVM FRITZ!DECT301 (FW: 04.88)
    • Thermostat
    • Function Values: temperature, hkr
  • AVM FRITZ!DECTRepeater100 (FW 04.16)
    • DECTRepeater
    • Function Values: temperature
  • AVM FRITZ!DECT400 (FW: 04.90)
    • Button
    • Function Values: button
  • Eurotronic CometDECT (FW 03.54)
    • Thermostat
    • Function Values: temperature, hkr

Function Value implementation:

  • base (this means generic device infos)
    • Graphs: None
    • Status: When Device present OK, else WARN
  • powermeter
    • Graphs: Consumption (kWh), Voltage (V), Power (W)
    • Status: Always okay
  • temperature
    • Graphs: Temperature Sensor
    • Status: Always okay
  • switch
    • Graphs: Switch State
    • Status: Always okay
  • hkr
    • Graphs: Temperature Thermostat, Battery, Window Open
    • Status: Compare against default params
  • button
    • Nothing yet (no idea what to check here)

How to setup

  • ensure you are working with checkmk 1.6
  • Install current package
  • Configure:
    • Create a new Host for your fritzbox
      • at DATA SOURCES > Check_MK Agent select "No Checkmk agent, all configured agents"
      • Save & Finish
    • Host & Service Parameters
    • search for fritz
    • Create an new rule in "Check state of Fritz!Box Smarthome Devices"
      • Enter Credentials, Port and Protocol
      • Explicit Host :
      • Save
    • (re)-inventory the (fritzbox) host, the smarthome devices should now be detected

Credits

Informations

AVM - AHA-HTTP-Interface Dokumentation

About

Extended CheckMK FritzBox Agent for SmartHome Devices.

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages