Webserver

Configuration --> Webserver

This enables you to set up DSLstats for remote monitoring over the internet or over your LAN.


Webserver


Enable webserver

Tick this box to start the webserver running, or untick it to stop the webserver.

Enable saving of webserver files

If you tick this box, the webserver files are saved locally but the webserver itself is not enabled. If the "Enable webserver" box is ticked, then this box is ticked but greyed out.

Port

Enter a port number from the range shown. The default port is 55555, and it can be edited only when the webserver is not running. You can choose any number from the indicated range, so long as it's not already in use by another service on your machine.

Delete files when webserver disabled

When this option is enabled, the webserver folder and its contents are deleted when the webserver is not enabled. If you enable the webserver later, the folder and its contents will be re-created.

Items to include (snapshots + html pages)

This section lists pages which can be viewed in a browser. Select the items which you want to monitor. Apart from Connection stats and Stats summary, only items which are currently being graphed can be selected here.
The last item "Combine selected items in one page" puts all the selected items into a single web page called "combined.html".

Items to include (snapshots only)

In this section there are three options for saving graph images and text files which can be incorporated in your own web pages.

Webpage refresh period

This option doesn't affect the operation of DSLstats in any way, but it sets the rate at which the remote browser will refresh the webserver page which it displays. By default, the refresh period is 30 seconds, but you can set it to be the same as the DSLstats graph sample period, or you can choose a custom value. After changing the value, press "Confirm" to implement the change.

Using the webserver for remote monitoring

You can display webserver pages in your browser, or you can incorporate webserver graphs and text files in pages on your own website.

1. Displaying pages in a browser

To display one of the selected pages, point your browser at the following URL:

http://<IP address>:<Port number>/<HTML file>

<HTML file> is one of the following:

SNR margin:    snrm.html
SNRM per band upstream:     snrmpbup.html
SNRM per band downstream:    snrmpbdown.html
Connection speed:    connspeed.html
Bitloading:    bitloading.html
CRC errors:     crc.html
FEC errors:     fec.html
Connection stats:     fullstats.html
Stats summary:      stats.html
Combined page:    combined.html

<Port number> is the webserver port which you've specified in DSLstats.

If you're doing this from a machine on your local network, then <IP address> is the IP address of the machine running DSLstats. But if you want to connect over the internet then you first have to configure the host system to accept external connections on your chosen port number. You do this in the router by setting up port forwarding, to forward your chosen port to the host machine. There's a lot of advice on port forwarding at http://portforward.com/ .

Having done this, <IP address> is the external IP address of the host system (as shown in the DSLstats event log).

Example URL:  http://20.30.40.50:55555/snrm.html

One problem with the above is that most systems have dynamic IP addresses, i.e. the allocated IP address changes when the modem re-syncs. To deal with this difficulty, you can sign up with a dynamic DNS service such as no-ip.com or dyndns.com. This service will keep track of your IP address and provide you with a URL which can be used to access your system. Most routers allow you to specify the dynamic DNS service which you use, so you can then access the webserver externally with a URL such as (for example):

http://myname.no-ip.biz:55555/snrm.html

2. Adding webserver graphs and text pages to your own website

Each image or text file you add to your page will have a URL of the form:

http://<IP address>:<Port number>/<image or text file name>

IP address and Port number are the same as above. The image and text file names can be:

SNR margin graph:    snrm.png
SNRM per band graph upstream:    snrmpbup.png
SNRM per band graph downstream:    snrmpbdown.png
Connection speed graph:    connspeed.png
Bitloading graph:    bitloading.png
CRC errors graph:    crc.png
FEC errors graph:    fec.png
QLN graph:   qln.png
HLog graph:    hlog.png
Traffic graph:    traffic.png
Errored seconds graph:    es.png

Stats summary:   stats.txt
Full stats:   fullstats.txt
SNR per tone data:    snrpertone.txt
Bitloading data:    bitloading.txt
pbParams data:    pbparams.txt
QLN data:   qln.txt
HLog data:   hlog.txt
Traffic data:    traffic.txt

Example URL:    http://myname.no-ip.biz:55555/snrm.png