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

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:
      • Consider having an automatic backup-restore script that runs when rebooting.
      • If you have a USB drive connected, set the Storage directory to a directory on that drive. NB Since pages are rendered by user 'nobody', the *.rrd files, the storage directory and all its parent directories need to be world readable. See https://forum.openwrt.org/t/trouble-with-luci-app-statistics-using-storage-directory-on-usb-drive/10683/4
      • Or use the Network sub-tab to send the statistics to another router/device that's acting as a collectd network listener.
    • Network sub-tab: collectd can either listen for other router's data, or send its data to other routers
docs/guide-user/luci/luci_app_statistics.txt · Last modified: 2018/09/03 17:13 by tmomas