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