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

It'll be much easier to debug things if you can provide screen shorts and/or any error messages that appear on the screen (other than this one).

If you're using Firefox or Chrome, please type `Ctrl`+`Shift`+`J` to open the JavaScript console and look for any errors associated with `yamon.js` (ignore any CSS messages and/or errors in any other files... those are beyond my control). In most cases, I expect that you'll find a message about an undeclared variable.

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.

Before you can [finally!] see your bandwidth utilization reports, you must first confirm or specify a couple of key values in the settings - in particular, you must:

  1. 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.(*)
  2. select whether you have unlimited bandwidth or a monthly usage allowance. If you have a cap, that value must be specified in GB.
  3. confirm the path to the data files on your web server (*), and
  4. 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 below, there are several other settings (but those are all optional). 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 check). Once all of the checks have been cleared, the page will automatically reload and you'll see your reports.

Your settings are permanently stored on this computer so you'll only have to do this once (yeah!). However you can return to the `Settings` tab at any time to revise or update these values. Please note that the settings are saved in `localStorage` variables - a [relatively] new HTML feature similar to (but more flexible than) `cookies`. Localstorage means that the information is stored 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've 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... [ → ]

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

ISP Billing Reset Date: ??? of every month

IntervalDownloadsUploadsTotalCap% of CapProjected
Total
+

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

: of the month

: GB/mo


:
 

:

:

:

:

Link

sec.

test

Reports

  • add trendline to totals summary
  • modify serverload table and graph a la active users table (will that reduce/eliminate the memory leak???)
  • My Page integration
  • database integration - store user/device info, ,migrate a number of the localStorage variables to the database, historical data, etc.
  • add security to the settings tab
  • add reverse DNS look up for external connections (or whois)... does OpenDNS hava a bulk check???
  • improve hover text in graphs
  • move JS for live usage reports to separate js file and elsewhere where possible
  • modify JS to support changes to data files (see below)
  • improve code efficiency?

YAMon Script

  • calculate total usage from proc/dev/net rather than using traff daemon (yeah... I know I had that in and then took it out but I'm now pretty sure I'm getting gross rounding errors from traff (in particular on the uploads))... in progress
  • add options to migrate all data to a database

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: The hourly usage file was updated:.

Users / DevicesAll DayUnlimited IntervalTotalPercent
DownloadsUploadsDownloadsUploads
:::Totals:::

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

Hourly Data Graph

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

(Usage in bytes)

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 / DevicesAll DayUnlimited IntervalTotalPercent
DownloadsUploadsDownloadsUploads
:::Totals:::

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 Down Up Total Agg. Daily Agg. Down Up Total Agg. Daily Agg.

Graphs → [ ]

All None

Users & Devices for:

This devices file was created and last updated .

A total of devices have connected to the router (at some point in time).

of those devices have been active during this reporting interval (i.e., more than 0 bytes of traffic).

User Device Name IP Address Mac Address Total Percent Updated
:::Totals::: -

Yet Another Monitor (YAMon) - Copyright © 2013-2014 Al Caughey, All rights reserved.