home-assistant.io/source/_integrations/fritzbox_netmonitor.markdown
Gerard 125b6720ed Update fritzbox_netmonitor.markdown (#11029)
Add extra info when using Docker regarding additional packages.
See comment from @frenck in #11019
2019-10-29 09:37:14 +01:00

2.8 KiB

title, description, logo, ha_category, ha_release, ha_iot_class
title description logo ha_category ha_release ha_iot_class
FRITZ!Box Net Monitor Instructions on how to integrate an AVM FRITZ!Box monitor into Home Assistant. avm.png
System Monitor
0.36 Local Polling

The fritzbox_netmonitor sensor monitors the network statistics exposed by AVM Fritz!Box routers.

If not running Home Assistant via Hass.io or Docker it might be necessary to install additional packages: sudo apt-get install libxslt-dev libxml2-dev python3-lxml If you are working with the All-in-One installation, you may also need to execute also within your virtual environment the command pip3 install lxml; be patient this will take a while.

To use the Fritz!Box network monitor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: fritzbox_netmonitor

{% configuration %} host: description: The IP address of your router, e.g., 192.168.1.1. It is optional since every fritzbox is also reachable by using the IP address 169.254.1.1. required: false default: 169.254.1.1 type: string name: description: Give the sensor a friendly name for in the front-end. required: false default: fritz_netmonitor type: string {% endconfiguration %}

The following statistics will be exposed as attributes.

Attribute Description
is_linked True if the FritzBox is physically linked to the provider
is_connected True if the FritzBox has established an internet-connection
wan_access_type Connection-type, can be DSL or Cable
external_ip External IP address
uptime Uptime in seconds
bytes_sent Bytes sent
bytes_received Bytes received
transmission_rate_up Current upstream speed in bytes/s
transmission_rate_down Current downstream speed in bytes/s
max_byte_rate_up Maximum upstream-rate in bytes/s
max_byte_rate_down Maximum downstream-rate in bytes/s

The sensor's state corresponds to the is_linked attribute and is either online, offline, or unavailable (in case connection to the router is lost).

This integration does not support "Fritz!Box 6490 Cable" with FritzOS 6.87 installed.