Site Tools


Bandwidth Monitoring

The Bandwidth Monitoring menu contains settings for Bandwidth Monitoring features. It is divided into sections which include Bandwidth Monitoring, Backup (of monitoring statistics in rstats format) and Restore.

Bandwidth Monitoring

Enable: This turns on the Bandwith Monitoring feature. (Default: Disabled).

Save History Location: This menu allows you choose where Bandwidth Monitoring history files will be saved.

  • RAM (Temporary) - This saves Bandwidth Monitoring history files to the router's RAM. It is temporary, since the contents disappear after a reboot, or a crash.
  • NVRAM - This saves Bandwidth Monitoring history to the router's NVRAM. NVRAM is permanent storage, but is often tiny on routers due to its higher cost.
  • JFFS2 - This will save monitoring files to a portion of the router's flash RAM that is formatted with the Journalling Flash File System, a log-structured file system. JFFS partitions are created and formatted in the Administration/JFFS menu. The storage space available will depend on the router's specifications, and the type/size of Tomato build installed. Tomato and any JFFS2 partitions occupy storage space on the same chip. Therefore, the larger the Tomato build, the less space there will be for JFFS2 partitions created. The process of firmware upgrades must rewrite the whole flash chip, and data on JFFS is destroyed. To avoid this, Tomato prevents you from allowing a firmware upgrade until JFFS is disabled. You will need to back up the data on your JFFS storage before a firmware upgrade.
  • CIFS1 - This will make Tomato write bandwidth logs to the first external CIFS network share configured. CIFS Client connections to CIFS shares are configured in the Administration/CIFS Client menu. CIFS is the Common Internet File System, a version of Microsoft's SMB networking protocol.
  • CIFS2 - This will let Tomato write bandwidth statistics to the second external CIFS share. CIFS network shares are configured in the Administration/CIFS Client menu.
  • Custom Path. This allows you to create a custom directory within the JFFS2 storage space. This is useful when you are also using JFFS2 for other storage tasks, and want to organize your storage into folders to keep data separate.

(Default: RAM).

Save Frequency: This specifies how often Bandwith Monitoring saves statistics to disk. (Default: TBD). The more often data is saved, the less likely you are to lose it due to bad events such as power outages or crashes.

Save on Shutdown: Checking this makes Tomato immediately save bandwidth statistics to disk if Tomato receives a shutdown signal. This prevents data loss.

Create New File: Checking this will erase your current statistics file and create a new one. This is useful when you switch storage media/locations (such as moving from RAM to CIFS). Tomato must create a new file in order for the statistics to be saved properly.

Create Backups: Enabling this makes Tomato create backup statistics logs. These backups are put in the same folder as the original files, and given a .bak file ending. (Default: Disabled).

First Day of the Month: The number entered here sets the first day of the month for Tomato's bandwidth logs. For example, if you entered 3, Tomato would make the third day of each month the first day to be recorded for bandwidth monitoring. This is usually set at 1. However, it is handy for use on certain Internet providers, which log/bill for bandwidth starting on a day other than the first day of the month. (Default: 1).

Excluded Interfaces: Here you can specify the Linux device name of any interfaces whose bandwidth you do not want to have monitored/logged. If you list multiple interfaces, the names should be separated with commas.


Here you can (re)name the backup bandwidth monitoring file, and back it up to a location you choose. In the empty field, you will see the default name of the statistics log file. If you click your cursor into that field, you can edit the filename given to the log file. Remember to click Save and wait for the changes to take effect.

Backup files are are saved in the standard Linux GNU .gz (gzip) file format. This is an archive format, similar to .zip, and can be easily opened by many programs across Windows, Linux, Macintosh and other systems.

Backup: Clicking on the Backup button will download the file to your web browser. The browser should open a window prompting you to either Open or Save the file. Generally, you choose Save, at which point your browser prompts you to browse for the location to save the backup log.

Hovering your mouse over the blue link entitled “link” will make your browser display the full path of the Bandwidth Monitor backup file location in the browser's status area. Clicking on the blue “link” link will also prompt you for where you want to store the existing Bandwidth Monitor backup file.


The Restore section contains a Browse… button which allows you go and find existing Bandwidth Monitoring logs you wish to restore to the storage location selected in the Save History Location menu. Tomato will expect to find the a Linux/GNU .gz (gzip) archive file.

If you use the Restore function to restore an existing Bandwidth Monitoring log to the same location it was originally store, Tomato will continue to log bandwidth statistics to the same file, picking up where it left off.

Technical notes and troubleshooting.

bandwidth_monitoring.txt · Last modified: 2021/02/01 04:17 by hogwild