Fritz!Box UPnP
Pack Assets​
Monitored Objects​
The Pack Fritz!Box collects metrics for:
- System
- Traffic
Collected Metrics​
- System
- Traffic
| Metric name | Description | Unit |
|---|---|---|
| connection status | Connection and physical link status | |
| system.uptime.seconds | Elapsed time since the last reboot | s |
| Metric name | Description | Unit |
|---|---|---|
| system.interface.wan.traffic.in.bitspersecond | Incoming traffic going through the WAN interface | b/s |
| system.interface.wan.traffic.out.bitspersecond | Outgoing traffic going through the WAN interface | b/s |
Prerequisites​
To control your Fritz!Box, the UPnP must be configured.
Setup​
- Online License
- Offline License
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Network-Fritzbox-Upnp
- On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the Fritz!Box UPnP Pack
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Network-Fritzbox-Upnp
- On the Centreon Central server, install the Centreon Pack from the RPM:
yum install centreon-pack-network-fritzbox-upnp
- 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:
| Mandatory | Name | Description |
|---|---|---|
| X | UPNPPORT | Port used (Default: 49000) |
| X | UPNPPROTO | Specify https if needed (Default: 'http') |
| UPNPEXTRAOPTIONS | Any 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