https://github.com/ryzhovau/rrdstorm

RRD-driven graph statistics for routers
https://github.com/ryzhovau/rrdstorm

bash entware rrdtool statistics

Last synced: 2 days ago
JSON representation

RRD-driven graph statistics for routers

• Host: GitHub
• URL: https://github.com/ryzhovau/rrdstorm
• Owner: ryzhovau
• License: gpl-2.0
• Created: 2012-09-09T14:07:20.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2013-06-27T10:25:26.000Z (over 11 years ago)
• Last Synced: 2023-03-29T01:15:32.496Z (almost 2 years ago)
• Topics: bash, entware, rrdtool, statistics
• Language: Shell
• Size: 281 KB
• Stars: 10
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
RRDStorm - A RRDTool graph tool for routers

==================================

This shell script helps you to collect various statistics about your router

and to visualize it with some cool graphs. See WIKI for a graph examples.

History

-----------------------

A first version was written for www.wl500g.info in 2005 for Asus WL-500G and now

it evolved to use on Asus RT-N66U.

 * Original thread: http://wl500g.info/showthread.php?2848-RRDTool-Traffic-Graph-Tutorial-Extremely-easy-to-follow-!

 * First version: http://pastebin.com/f77e330b5

 * Version 1.3: http://pastebin.com/f789cf38a

 * Current version: now here, on https://github.com/ryzhovau/rrdstorm

I've commited all this versions for history.

Requirements

-----------------------

 * rrdtool - a package from Entware/Optware/OpenWRT repositories,

 * bash - required because of arrays, a shell from busybox is not sufficient,

 * cron - to collect data periodically,

 * web server - to serve static HTML files and PNG images with stat visualization.

Installation and configuration

-----------------------

1) Place rrdstorm.sh to router and make sure it executable.

2) Look into rrdstorm.sh and change path to Round Robin DB storage,

path to WWW root, check HDD partition names and other sensors definitions.

Default values is for Entware/Optware.

3) Initialize RRD database

    $ rrdstorm.sh create 0 1 2 3 4 5 6

where 0..6 is a sensor numbers. You may use only some of them:

 * 0 - Average system load,

 * 1 - RAM usage,

 * 2 - Wireless PHY's temperatures,

 * 3 - CPU usage,

 * 4 - WAN traffic statistics,

 * 5 - Disk space,

 * 6 - Wireless outgoing traffic.

4) Create a cron job to collect sensors data every minute:

    $ rrdstorm.sh update 0 1 2 3 4 5 6

5) Create a cron job to update graphs as soon as you wish, i.e. every hour:

    $ rrdstorm.sh graph_cron h 0 1 2 3 4 5 6

where h is a drawing period. Avaliable periods:

 * s - 1 hour graphs,

 * h - 4 hours graphs,

 * d - 24 hours graphs,

 * w -  weekly graphs,

 * m - monthly graphs,

 * y - yearly graphs.

If you want to draw graphs for all those periods use:

    $ rrdstorm.sh graph 0 1 2 3 4 5 6

On a Asus RT-N66U last one takes ~3,5 minutes. See a WIKI pages for graph

examples. Feel free to use and to discuss rrdstorm.sh here or at www.wl500g.info

License

-------

See the LICENSE file in the source code for the license terms.