This is an old revision of the document!
The Logging Page is divided into two sections. The Syslog section contains settings to enable and configure settings for Syslog, FreshTomato's main logging function. This function logs technical events. The Web Monitoring section contains settings to enable and configure FreshTomato's Web Monitoring function. Web Monitoring is used to monitor log/monitor web searches and which domains have been visited.
Log Internally: This enables FreshTomato's logging. By default, FreshTomato saves logs to the router's internal memory, where they may be extracted or viewed directly on the Logs page. These logs will consume router memory, but may be viewed directly on the router itself. (Default: Enabled).
Max size before rotate: Log rotation is a process that creates new log files and archives & removes old ones to save on drive space. The number entered here specifies the maximum storage space log files can occupy before they are rotated, in Kilobytes.
Number of rotated logs to keep: This specifies the
Custom Log File Path: Checking this box allows you to specify a custom path for your log file. A tip is shown on this menu reminding you to make sure the path exists and is writable. (Deafult path: /var/log/messages).
Log To Remote System: Checking this enables the syslog function, allowing you log remotely, on a client PC or other device. Enabling this will cause the Host or IP Address / Port fields to pop up, prompting you to fill those in. Remote syslog software can make it easier to interpet/understand log results. For example, it can be used to display the logs in graphical form, and/or help to explain the log entries.
IP Address / Port: In these two fields, you enter the IP address of the host machine to which syslog data will be directed, and the TCP/IP port which will be used to send that data.
Generate Marker: This makes log files easier to read. Checking this causes the word “——MARK—–” to be inserted into the log
at the specified interval.
Limit: This specifies the maximum number of messages per minute the system will log. Enter '0' for unlimited. (Default: 60).
Clicking Enable » Takes you to the Administration/Logging page (including Syslog settings)
Monitor Web Usage: Checking or unchecking this enables or disables Web Monitoring. (Default: Disabled)
Monitor: Select the Device/s you wish to monitor (All Computers / The following / All except). (Default: All Computers/Devices).
Number of Entries to remember: Here you enter the number of Domains visited and the number of Searches FreshTomato will record in the log file. Setting this to 0 makes the number of domains and searches unlimited (and therefore) allows an unlimited log size.
Daily Backup: If checked, this will enable backup of Web Monitor logs to the default backup directory. (Default: Disabled).
Clear Data After Backup: if selected, this will empty the log file after the backup is performed. (Default: Disabled)
Backup Directory: This specifies where the backup files will be stored. (Default: /tmp).
NOTE: the content of the default (\tmp) folder will be emptied ater a reboot. You might consider using USB/CIFS/JFFS storage as an alternative for more permanent storage.
NOTE REGARDING ENCRYPTION: Web usage will not work properly if the FreshTomato client you wish to monitor is running a direct TOR or VPN connection to the Internet. FreshTomato can't monitor direct TOR or VPN connections because they are already encrypted.