User Tools

Site Tools


docs:guide-user:luci:luci_app_statistics

luci-app-statistics

Out of the box, OpenWRT can show you real-time statistics, however it will not store the data for historical view. Install luci-app-statistics to have a nice historical data graphs for router, eg: ping, interfaces bandwidth utilization, cpu load, ram, disk, uptime, etc…

To see all the available collectd-modules, run: opkg list | grep collectd-mod

I've found the original description located at: https://advanxer.com/blog/2013/02/openwrt-monitoring-using-collectd/ Thanks to advanxer.com!

collectd+rrdtool

luci-app-statistics is a collectd and rrdtool based statistics tool. For more details about collectd and rrdtool, see statistical.data.overview

For other Bandwidth Monitoring tools, see bwmon

Installation

The luci-app-statistics package is based on Collectd and uses RRD Tool to render diagram images from collected data.

1. opkg update and install (326 KB)

opkg update
opkg install luci-app-statistics

2. Install desired plugins (60 KB)

opkg list | grep collectd-mod
opkg install collectd-mod-cpu collectd-mod-interface collectd-mod-memory collectd-mod-ping collectd-mod-rrdtool collectd-mod-wireless

3. Enable daemons

/etc/init.d/luci_statistics enable
/etc/init.d/collectd enable

4. Create default rrd directory

mkdir /tmp/rrd
chown -R nobody:nogroup /tmp/rrd

This creates default data directory. Without this directory, you will not have any graphs out of the box. Note that the directory resides in ramdisk. Graphs and data are lost after a reboot. It is also a good idea to add the comments above to /etc/rc.local to create the directory after a reboot.

Instead, you can also configure a persistent storage location - see below.

Configuration

Configuration via UCI:

  • View the config with uci export luci_statistics
  • Edit /etc/config/luci_statistics to make changes.

Configuration via LuCI: After installing the packages, a new menu appears. See the config pages in Statistics→Setup All the installed collectd-modules will shown here, but only some of them are enabled by default.

Suggested configuration

  • General Plugins tab: Review the sub-tabs to choose which statistics to monitor
  • Network Plugins tab: Select which interfaces to monitor
  • Output Plugins tab:
    • RRDtool sub-tab: To protect flash-memory from wearing out, the default Storage directory is /tmp/rrd. All statistics data will be lost on reboot. Alternatives:
    • Network sub-tab: collectd can either listen for other router's data, or send its data to other routers
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/guide-user/luci/luci_app_statistics.txt · Last modified: 2020/09/15 11:36 by tmomas