home-assistant.io/source/_integrations/fritzbox_netmonitor.markdown
Sven-Hendrik Haase 5f099fdf5f
Remove outdated note (#12490)
This is no longer valid since fritzconnect 1.20 now supports newer FritzOS versions.
2020-03-23 10:17:28 +01:00

2.4 KiB

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

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

Configuration

For this integration to function properly, you need to have "UPnP Statusinformation transfer" activated on the AVM FRITZ!Box. Please make sure you have that enabled.

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 FRITZ!Box 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 FRITZ!Box is physically linked to the provider
is_connected True if the FRITZ!Box has established an internet-connection
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).