> Note: > > This check plugin is no longer actively maintained. > For the motives and alternatives please read the following comment: > https://github.com/mcktr/check_tr64_fritz/issues/80

check_tr64_fritz

Table of Contents

1. Introduction
2. Support
3. Requirements
4. Usage
5. CheckCommand
6. Security
7. Contributors
8. Thanks
9. Development

Introduction

This is a check plugin for Icinga 2 to monitor a Fritz!Box.

Support

If you have any questions, please hop onto the community channels.

Requirements

Required packages

The following packages are required to use this check plugin.

• curl
• bc

Please use your favorite package manager to install them.

Fritz!Box configuration

The TR-064 feature must be enabled on the Fritz!Box. You can enable the feature in the following menu:

Heimnetz -> Netzwerk, switch over to the tab Netzwerkeinstellungen

The setting Zugriff für Anwendungen zulassen must be activated. After a restart of your Fritz!Box the TR-064 feature is activated.

> Note: > > You may need to activate the advanced view (Erweiterte Ansicht) to see the setting.

Installation

1. Get the latest stable release
2. Extract the archive
3. Execute the getSecurityPort script, to find your TR-064 SSL port
4. Copy the check_tr64_fritz script to your Icinga 2 check plugin directory
5. Add the CheckCommand definition to your Icinga 2 configuration.
6. Create a new service in Icinga 2 for your Fritz!Box

You can find additional information on how to setup check plugins for Icinga 2 in the offical Icinga 2 documentation

Usage

getSecurityPort

getSecurityPort 

Example:

$ ./getSecurityPort 192.168.178.1
Your Fritz!Box Security Port (for TR-064 over SSL) is: 49443

check_tr64_fritz

check_tr64_fritz -h  -p  -u  -P  -f  -w  -c 

Arguments

> Note: > > The username and password are the same as for the web interface of your > Fritz!Box. If you don't use the login method with username and password, you > can leave the username empty.

Functions

Indexes

> Note: > > You can specify the index with a double point and the index number after the function name e.g. thermometer:3.

Example:

$ ./check_tr64_fritz -P password -f uptime
OK - Uptime 29990 seconds (0d 8h 19m 50s) | uptime=2999

$ ./check_tr64_fritz -P password -f status:cable
WARNING - Connecting | status=1

$ ./check_tr64_fritz -P password -f thermometer:3
OK - Comet DECT 03.68 - Wohnzimmer CONNECTED 21.5 °C | thermometer_current_state=0 thermometer_current_temp=21.5 warn=0 crit=0

> Note: > > Please also read the seperate documentation about the Smart Home index

CheckCommand

You can use the following CheckCommand definition for your Icinga 2 configuration.

object CheckCommand "check_tr64_fritz" {
  command = [ PluginDir + "/check_tr64_fritz" ]

  arguments = {
    "-h" = "$fritz_host$"
    "-p" = "$fritz_port$"
    "-u" = "$fritz_username$"
    "-P" = "$fritz_password$"
    "-f" = "$fritz_function$"
    "-w" = "$fritz_warning$"
    "-c" = "$fritz_critical$"
  }

  vars.fritz_host = "$address$"
  vars.fritz_port = "49443"
  vars.fritz_username = "dslf-config"
  vars.fritz_function = "status"
}

You can find more information about a CheckCommand definition inside the offical Icinga 2 documentation.

Security

Authentication

You can use an independently account for the authentication against the Fritz!Box.

1. Login to your Fritz!Box
2. Navigate to System -> Fritz!Box-Benutzer

Here you can add a new user to your Fritz!Box. The user needs at least the following permissions to work properly.

• _FRITZ!Box Einstellungen__
• Sprachnachrichten, Faxnachrichten, FRITZ!App Fon und Anrufliste
• Smart Home

Script

The check_tr64_script use SSL to communicate with the Fritz!Box. Therefore you need to find out your SSL port for the TR-064 protocol. Please use the script getSecurityPort to find out the port that is used by your Fritz!Box.

> Note: > > The script getSecurityPort don't use the SSL protocol to communitcate with > the Fritz!Box. The information about the used port for TR-064 over SSL is > available without authentication against the Fritz!Box.

Icinga Web 2

You must specify your Fritz!Box password inside your Icinga 2 configuration to monitor your Fritz!Box, therefore ensure that you are hiding the custom password attribute in Icinga Web 2.

1. Log in to Icinga Web 2.
2. Go to Configuration -> Modules -> monitoring -> Security.
3. Ensure that your custom password attribute is protected (defaults are *pw*,*pass*,community). If you named your custom variable fritz_password it will be protected by the default entry *pass*.
4. Check it by going to one of your Fritz!Box service and check if the password is display with ***.

Contributors

• mcktr

Thanks to all contributors!

• cxcv for fixing a bug with performance data output
• uclara for proposing to add adjustable warning/critical values for the functions down-/upstream
• matthenning for reporting and helping resolving a bug on Fritz!Box cable models

Thanks

• FRITZ!Box mit Nagios überwachen
• Fritz!Box and TR-064

Development

Fork the project to your GitHub account, commit your changes and send a pull request. For developing on this project it is advantageous to have a Fritz!Box at your place to test your changes.

Before we start to fetching and parsing the TR-064 data we need to know which data our Fritz!Box provides. We can either fetch a list of this directly from the Fritz!Box or we can also look into the documentation from the manufacturer AVM. It is good to do both, make sure that the data we want to fetch is supported by AVM and our Fritz!Box actually provides it.

You can fetch the list directly from the Fritz!Box, go to http://:49000/tr64desc.xml to fetch this list. You will get a XML file that contains many entries and it looks like the following.

[...]

  serviceType>urn:dslforum-org:service:DeviceInfo:1
  serviceId>urn:DeviceInfo-com:serviceId:DeviceInfo1
  controlURL>/upnp/control/deviceinfo
  eventSubURL>/upnp/control/deviceinfo
  SCPDURL>/deviceinfoSCPD.xml

[...]

You can find the manufacturer documentation here. Have a look into the PDF files and search for a action that provides your needed data.

To finally create our TR-064 request we need three information beforehand.

1. The serviceType e.g. DeviceInfo
2. The controlURL e.g. deviceinfo (Only the last part after the slash.)
3. The action e.g. 'GetInfo' (Look into the manufacturer documentation to find those.)

Inside the devel directory you can find a bash script, that allows you to fetch the raw TR-064 data (basically in XML format).

fetch_tr64_data.sh

This script fetches and output the raw TR-064 data.

Arugments

Example:

./fetch_tr64_data.sh -P [PASSWORD] -U deviceinfo -s DeviceInfo -a GetInfo

fritz.box
49443
dslf-config
[PASSWORD]
deviceinfo
DeviceInfo
GetInfo

<?xml version="1.0"?>

AVM
00040E
FRITZ!Box 7490
FRITZ!Box 7490 113.06.92
FRITZ!Box
[SERIALNO.]
113.06.92
FRITZ!Box 7490
1.0
[CODE]
97384

[LOG]

Now you can see the raw TR-064 and see if your needed information is in there. If yes you can now extend the check plugin script and parsing the output to output the result in a proper format.