Yet Another Monitor

Refreshing in: 120 sec.
Router GUI

Uh oh... something bad has occurred in the JavaScript... if things were running properly, this text would have been deleted. Please contact Al and let him know you're experiencing a problem.

Summary Settings Changes To Do List Credits FAQ

Welcome to the `Yet Another Monitor` reports...

The good news is that you've gotten to this page so presumably you've gotten everything installed properly. This is the last step before you can see your bandwidth utilization reports!

You have to now confirm or specify a number of key parameters for the reports - in particular, you must:

enter the day of the month on which your ISP billing cycle starts. If you do not have a billing cycle then enter any date that you want.(*)
select whether you have unlimited bandwidth or a monthly usage allowance. If you have a cap, that value must be specified in GB.
confirm the path to the data files on your web server (*), and
confirm the name of the users and the usage data files created by the `jamon.sh` script (*).

Note - (*) if these values don't match what you have in your `config.file`, you'll get an error alert when you open or reload the page. You'll likely also get incorrect results in the reports.

As you can see, there are a variety of other settings but those are all optional. All of the required fields are prefaced with and those that which need to be confirmed have a green checkmark ( ✔ ) following. Click the checkmark to accept the pre-defined default value or set it to your preferred value (and then click the checkmark). Once all of the checks have been cleared, the script will automatically reload the page and you'll see the reports. Return to the `Settings` tab at any time to revise these values.

Your settings are permanently stored so you'll only have to do this once (yeah!). However, they are saved using `localStorage` - a [relatively] new HTML feature similar to (but more flexible than) `cookies` - that retains this information on *this* computer and in *this* browser only. This means that if you want to view the reports in a different browser or on a different computer/device, you'll have to confirm your settings there too... sorry, but that's the way `localStorage` works. I added the `Export Settings` and `Import Settings` buttons to provide a functional (but not exactly pretty) way to synchronize your settings between devices.

Default Settings:

Changes Legend:

bytes

kilobytes

megabytes

gigabytes

terabytes

petabytes

all others

Reporting Interval:

Reporting Data for:

All Bandwidth is still loading... [ → MBytes Auto ]

Internet Usage Cap: Not Set... see 'Settings' tab

ISP Billing Reset Date: ??? of every month

Interval	Downloads	Uploads	Total	Cap	% of Cap	Projected Total

You must specify and/or confirm the value for all required fields. The others are optional (or you can accept the defaults).

test

add `live` stats (updated every 10 sec or so)... probably a table and perhaps a chart. This'll require changes to the yamon.sh script (to dump data every time it updates things)... presumably there'll have to be a flag in the config.file to turn this feature on/off. I wonder how much additional load this'll add to the router CPU.
modify the web code so that you do not have to edit users.file when a new device is added to your network - i.e., the users.file (or users.html on the web server) will contain the MAC address and based upon that (or a hashcode of the MAC), lookup the friendly name for the user & device. Retaining the user/device info in localStorage will be pretty simple to implement solution
add a last hour report - i.e., a rolling report for the past 60 minutes (in 5min intervals) showing uploads/downloads by user/device. Again probably a table and chart
set this up as a google code project to improve version control

If you have any questions/suggestions or find an error, drop me a line. I'll do my best to respond ASAP!

By: Al Caughey

Version: Jul 4 2013

Based upon: wrtbwmon by Emmanuel Brucy & bw_monitor by FezJay
And, adapted from modifications by: `bpsmicro`, `OrionShock` & others

Thanks to `spanman` and everyone else who's made suggestion for improvements and/or found bugs

If you have any questions/suggestions or find an error, drop me a line. I'll do my best to respond ASAP!

test

Daily Usage Live Updates Monthly Totals Monthly Breakdown Devices

Current Day:

Click any name or device in the table below to see the usage breakdown by day.

Click the `Users / Devices` column heading to show/hide the devices.

Click the coloured box to the left of a device name to hide/show that device in the hourly chart below

Devices in Hourly Graph:

Users / Devices	All Day		Unlimited Interval		Total	Percent
Users / Devices	Downloads	Uploads	Downloads	Uploads	Total	Percent
There is no data for the selected date!
					0	-

... use this feature if you've accidentally stopped the monitor or if things went haywire.

To see any meaningful information on this tab, you must
a) set `_doLiveUpdates=1` in `config.file` on your router, and
b) select the `Show Live Updates` checkbox on the `Settings` tab above.

The data on this tab is aggregated from the `live_data.js` file. The information will be updated every 10s (or whatever value you have set for `_updatefreq` in your `config.file` on the router). If you reload this page, the contents of this tab will be lost.

Server load:

Free Memory: bytes

Time1-minute5-minute15-minute

TimeOwnerDeviceDownloads
TotalKB/sUploads
TotalKB/s

Con	Source	Port	Destination	Port

Monthly Usage Totals for:

Click any name or device in the table below to see the usage breakdown by day.

Users / Devices	All Day		Unlimited Interval		Total	Percent
Users / Devices	Downloads	Uploads	Downloads	Uploads	Total	Percent
Corrections						-

Monthly Usage Breakdown for:

Filter data by User or Device:

Click any date in the table below to see the usage breakdown by user/device for that date.

Date	Router (units as indicated)				(all units in MB) Link						Traff daemon
	All Day		Unlimited		Total	Agg.	Details				Differences		Details				Differences
	Down	Up	Downloads	Uploads	Total	Agg.	Down	Up	Total	Agg.	Daily	Agg.	Down	Up	Total	Agg.	Daily	Agg.

Graphs → [ ]

All None Downloads Uploads Totals Cumulative Differences Differences (in %) Cumulative Difference Cumulative Difference (in %)

Users & Devices for:

User	Device Name	IP Address	Mac Address	Total	Percent