Site Tools


logging

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
logging [2021/05/15 18:32] – [Syslog] hogwildlogging [2022/01/11 20:53] (current) – [Web Monitor]-changed "as an alternative" to "instead" hogwild
Line 1: Line 1:
 ====== Logging ====== ====== Logging ======
  
-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. +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 system 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.
  
 ===== Syslog ===== ===== Syslog =====
Line 9: Line 8:
  
 **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. **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.
 +
 + \\
 +
 +{{https://wiki.freshtomato.org/lib/plugins/ckgedit/fckeditor/userfiles/image/logging-syslog.jpg?979x560&nolink|wiki.freshtomato.org_lib_plugins_ckgedit_fckeditor_userfiles_image_logging-syslog.jpg}}
 +
 +** ** \\
  
 **Number of rotated logs to keep:** This specifies the **Number of rotated logs to keep:** This specifies the
Line 14: Line 19:
 **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). **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 deviceEnabling this will cause the Host or IP Address / Port fields to pop up, prompting you to fill those in.+**Log To Remote System: **Checking this provide network support to the syslogd facilityNetwork support means that messages can be forwarded from one node running syslogd to another node running syslogd where they will be actually logged to a disk file(( 
 +[[https://linux.die.net/man/8/syslogd|https://linux.die.net/man/8/syslogd]] 
 +))
  
 **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. **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 the word "——MARK—–" to be inserted into the log\\ +**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.
-at the specified interval.+
  
   * Disabled   * Disabled
Line 29: Line 35:
  
   * Access Restriction - Checking this causes Access Restriction events to be logged.   * Access Restriction - Checking this causes Access Restriction events to be logged.
-  * Cron - Causes (Linux) Cron events to be logged.+  * Cron - Causes Cron events to be logged.
   * DHCP Client - Causes DHCP IP addressing events to be logged.   * DHCP Client - Causes DHCP IP addressing events to be logged.
   * NTP - Causes Network Time Protocol events to be logged.   * NTP - Causes Network Time Protocol events to be logged.
Line 36: Line 42:
 **Connection Logging: ** **Connection Logging: **
  
-  * **Inbound** \\ Disabled \\ If Blocked by Firewall \\ If Allowed by FirewallBoth +  * **Inbound** \\ Disabled - Disables logging of incoming connections. \\ If Blocked by Firewall - Logs incoming connection attempts blocked by the firewall. \\ If Allowed by Firewall - Logs incoming connection attempts allowed by the firewall. \\ Both - Logs all incoming connection attempts. 
-  * **Outbound ** \\ ptions: DisabledIf Blocked by FirewallIf Allowed by Firewall, Both +  * **Outbound** \\ Disabled - Disables logging of outgoing connections. \\ If Blocked by Firewall - Logs outgoing connection attempts blocked by the firewall. \\ If Allowed by Firewall - Logs outgoing connection attempts allowed by the firewall\\ Both - Logs all outgoing connection attempts.
-**Limit:**  Entering a value here specifies the maximum number of messages per minute the system will logEnter '0' for unlimited.+
  
 +**Limit:**  This specifies the maximum number of messages per minute the system will log. Enter '0' for unlimited. (Default: 60).
  
 ===== Web Monitor ===== ===== Web Monitor =====
Line 45: Line 51:
 Clicking **Enable >>** Takes you to the Administration/Logging page (including Syslog settings) 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 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). **Monitor**: Select the Device/s you wish to monitor (All Computers / The following / All except). (Default: All Computers/Devices).
 +
 + \\
  
 [[https://wiki.freshtomato.org/lib/exe/detail.php?id=web_usage&media=pasted:20200521-200701.png|{{:pasted:20200521-200701.png}}]] [[https://wiki.freshtomato.org/lib/exe/detail.php?id=web_usage&media=pasted:20200521-200701.png|{{:pasted:20200521-200701.png}}]]
 +
 + \\
 +
 + \\
  
 **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. **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.
Line 59: Line 71:
 **Backup Directory**: This specifies where the backup files will be stored. (Default: /tmp). **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: the content of the default (\tmp) folder will be emptied ater a reboot. You might consider using USB/CIFS/JFFS storage instead for more permanent storage. 
 + 
 + 
 +===== Web Usage/Web Monitor Notes =====
  
-\\ +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 cannot monitor direct TOR or VPN connections because they are already encrypted.
-NOTE: 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'monitor direct TOR or VPN connections because they are already encrypted.+
  
  
logging.1621099938.txt.gz · Last modified: 2021/05/15 18:32 by hogwild