Skip to main content

Fritz!Box UPnP

Pack Assets​

Monitored Objects​

The Pack Fritz!Box collects metrics for:

  • System
  • Traffic

Collected Metrics​

Metric nameDescriptionUnit
connection statusConnection and physical link status
system.uptime.secondsElapsed time since the last reboots

Prerequisites​

To control your Fritz!Box, the UPnP must be configured.

Setup​

  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Network-Fritzbox-Upnp
  1. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the Fritz!Box UPnP Pack

Host configuration​

  • Add a new Host and fill the IP Address/FQDN, SNMP Version and SNMP Community fields according to the device's configuration
  • Apply the Net-Fritzbox-UPNP-custom Host Template

Once the template applied, some Macros have to be configured:

MandatoryNameDescription
XUPNPPORTPort used (Default: 49000)
XUPNPPROTOSpecify https if needed (Default: 'http')
UPNPEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

How to test the Plugin and what are the main options for?​

Once the plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command (Parameters such as api-username or api-passwordhave to be adjusted):

/usr/lib/centreon/plugins/centreon_fritzbox_upnp.pl \
--plugin=network::fritzbox::upnp::plugin \
--mode=traffic \
--hostname='10.30.2.79' \
--port='49000' \
--proto='http'

Expected command output is shown below:

OK: Traffic In: 1.29 Mb/s, Traffic Out: 1.49 Mb/s | 'system.interface.wan.traffic.in.bitspersecond'=1287234b/s;;;0;10000000 'system.interface.wan.traffic.in.bitspersecond'=1487235b/s;;;0;10000000

The command above monitors WAN interface traffic (--mode=traffic).

It connects to the host 10.30.2.79 (--hostname='10.30.2.79') on the port 49000 (--port='49000') using http (--proto='http').

All the options as well as all the available thresholds can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/centreon_fritzbox_upnp.pl \
--plugin=network::fritzbox::upnp::plugin \
--mode=traffic \
--help

Troubleshooting​

Troubleshooting plugins