Network Weathermap – Network Map Tool

Bandwidth MapRecently I came across a neat program written in PHP, called Network Weathermap ( It helps you with drawing a network map and shows live data on it. I never seen it before, although it’s been around for quite a while. I decided to post a tutorial of it because there are still people out there that don’t know about it.

  • Webserver with PHP support
  • rrdtool installed
  • php-gd libraries installed

Installation is quite straightforward. I installed the old version from the website 0.97c, but you can get a newer version with bootstrap and jquery on GitHub ( It does need some additional installation of libraries, but for my proof of concept, I’ll use the old one.

Grab it here: and put it in your web directory.

After successful extraction, you should visit: http://mywebserver/weathermap/check.php and ensure everything there is green. Make sure you chmoded ./configs directory, so that webserver can write to it.

My example map

Here’s zip file of example files:

You should put example.conf into ./configs directory, data.txt into weathermap’s root directory and host.png to ./images directory.


Go to root directory and let’s generate a first weathermap:

./weathermap --config configs/example.conf --output=example.png --htmloutput example.html

Voila! You have your own network map, generated and filled from data in data.txt.  Access it on: http://mywebserver/weathermap/example.html


Now let’s get a little bit into weathermap itself. As you can see config has few sections, one for nodes, and one for links. To create nodes and links I would suggest you using editor that comes with the software. To enable editor edit ./weathermap/editor.php on 4th line:


Now we have an editor in place and we can reach it on http://mywebserver/weathermap/editor.php. Choose example.conf to open my example config for customization.

Pushing of data

There are several ways to push data to the weathermap:

  • RRD file
  • Simple text file
  • SNMP Oid
  • Custom script

I found out, that generating a simple text file with all necessary data to plot is the easiest. (One aggregated data file for all data sources – great for automation.)
RRD is useful if you put this weathermap on cacti server, so it can access local rrd files. See more options for TARGET parameter on:

For generating data.txt file I simply wrote a script that SNMP walked my edge routers and generated a data.txt file. If you open the file, you will see each router connection is represented as:

<link name> <in traffic> <out traffic>

The <link name> should match the link name in example.conf.


Here are 2 examples of my maps:

Latency Map

Bandwidth Map


More maps?

If you run out of ideas, see: for more suggestions on what kind of maps you can create.


  1. By richard dunne


    • Reply

  2. By Alex Cardoso


Leave a Reply

Purpose of the commenting system is to share your experience. I encourage you to post feedback with your own suggestions, ideas or optimizations regarding the topic of a blog post. What commenting system isn't for, is asking questions about similar issues of yours and requesting support for it. Blog post is provided as is and I am not here to solve all your problems. Please bear that in mind and try to avoid posting such comments. I do take privilege to remove comment from my blog for any reason whatsoever. Usually I do it when I sense a comment was posted only for spam/seo reasons or is out of blog post's topic. Thank you for reading this, now you may continue :)

Your email address will not be published. Required fields are marked *