---
title: ''
description: Telegraf plugin for collecting metrics from Fritzbox Smarthome
url: https://docs.influxdata.com/telegraf/v1/input-plugins/fritzbox_smarthome/
estimated_tokens: 1053
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/fritzbox_smarthome/
date: '2026-09-07T21:21:55+01:00'
lastmod: '2026-09-07T21:21:55+01:00'
---

==========

* Telegraf v1.40.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.40.0/plugins/inputs/fritzbox_smarthome/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.40.0/plugins/inputs/fritzbox_smarthome/sample.conf)

# Fritzbox Smarthome Input Plugin

This plugin gathers status information from Smarthome capable [FRITZ!](https://fritz.com/)routers using the device’s [AVM Home Automation](https://fritz.com/en/pages/interfaces) interface.

**Introduced in:** Telegraf v1.40.0**Tags:** network, iot**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Gather fritzbox smarthome status
[[inputs.fritzbox_smarthome]]
  ## URLs of the devices to query including login credentials
  urls = [ "http://user:password@fritz.box/" ]

  ## The http timeout to use.
  # timeout = "10s"

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"
  # tls_key_pwd = "secret"
  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false
```

## Metrics

By default field names are directly derived from the corresponding [interface
specification](https://fritz.com/en/pages/interfaces).

* `fritzbox_smarthome_device`
  * tags
    * `source` - The hostname of the router
    * `manufacturer` - The manufacturer of the smarthome device
    * `product_category` - The category (e.g. sensor, button)
    * `power_source` - The power source (internal, external, battery)

  * fields
    * `name` (string) - Device’s name (as given by user).
    * `product_name` (string) - Device’s product name.
    * `connected` (bool) - Device’s connected status.
    * `battery_value` (int) - Device’s battery level (0-100).
    * `battery_low` (bool) - Device’s battery low state.
    * `update_available` (bool) - Device’s software update available state.

* `fritzbox_smarthome_multimeter`
  * tags
    * `source` - The name of the router (this metric has been queried from)
    * `group` - The group this unit is assigned to (\<none\> if unassigned)
    * `type` - The type of the unit (as reported by the API; e.g. dimmableLight)

  * fields
    * `name` (string) - The name of the unit or group.
    * `energy` (int) - Overall energy consumption (Wh).
    * `power` (int) - Latest power consumption (mW).
    * `voltage` (int) - Latest voltage (mV).
    * `current` (int) - Latest current (mA).

* `fritzbox_smarthome_level_control`
  * tags
    * `source` - The name of the router (this metric has been queried from)
    * `group` - The group this unit is assigned to (\<none\> if unassigned)
    * `type` - The type of the unit (as reported by the API; e.g. dimmableLight)

  * fields
    * `name` (string) - The name of the unit or group.
    * `level` (int) - The current light level (0-100).

* `fritzbox_smarthome_on_off`
  * tags
    * `source` - The name of the router (this metric has been queried from)
    * `group` - The group this unit is assigned to (\<none\> if unassigned)
    * `type` - The type of the unit (as reported by the API; e.g. dimmableLight)

  * fields
    * `name` (string) - The name of the unit or group.
    * `active`(bool) - The current active state.

## Example Output

```text
fritzbox_smarthome_device,manufacturer=AVM,power_source=battery,product_category=sensor,source=127.0.0.1 connected=true,battery_value=100i,battery_low=false,update_available=false,name="Name#1",product_name="FRITZ!Smart Energy 250" 1787604406292123000
fritzbox_smarthome_multimeter,group=<none>,source=127.0.0.1,type=avmMeter energy=325528i,power=289130i,voltage=0i,name="Name#1",current=0i 1787604406292152000
fritzbox_smarthome_level_control,group=Name#3,source=127.0.0.1,type=dimmableLight name="Name#2",level=100i 1787604406292154000
fritzbox_smarthome_on_off,group=Name#3,source=127.0.0.1,type=dimmableLight name="Name#2",active=false 1787604406292156000
```