Differences

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

--- admin-log [2024/09/15 02:21] – [Web Monitor] -condense hogwild
+++ admin-log [2025/03/09 15:11] (current) – [Syslog] -Condense Log to Remote System hogwild
@@ Line 1: / Line 1: @@
 ====== 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 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.
+The Logging Page contains two sections. The Syslog section has settings to enable and configure settings for Syslog, the main function that logs system events. Web Monitoring contains settings to enable/configure the function to let you monitor log/monitor web searches and which domains have been visited.
 ===== Syslog =====
-**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 [[status-log|Logs]] page. These logs will consume router memory, but may be viewed directly on the router itself. (Default: Enabled).
+**Log Internally: **enables FreshTomato logging.
+By default, FreshTomato saves logs to the router's internal memory, where they may be extracted or viewed directly on the [[status-log|Logs]] page. The logs consume router memory, but may be viewed directly on the router itself. (Default: Enabled).
+ \\
+**Max size before rotate: **// //specifies the maximum space log files can occupy before they are rotated, (in Kb).
-**Max size before rotate: **// Log rotation// is a process that creates new log files and archives & removes old ones to save drive space. The number entered here specifies the maximum storage space log files can occupy before they are rotated, (in Kb).
+//Log rotation// creates new log files and archives & removes old ones to save drive space. The number entered here
- \\ {{::administration-logging-syslog-2024.1.png?696}}
+ \\  \\ {{::administration-logging-syslog-2024.1.png?696}}
 ** ** \\
-**Number of rotated logs to keep:** Specifies how many rotated log files will be maintained in the archive of rotated logs.
+**Number of rotated logs to keep:** specifies how many rotated log files will be maintained in the rotated logs archive.
-**Custom Log File Path: **Enabling this lets you specify a custom path for the log file. A tip is displayed, reminding you to check the path exists and is writable. (Deafult path: /var/log/messages).
+ \\
-**Log To Remote System: **Enabling this provides network support to the syslogd facility. Network 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. ((
+**Custom Log File Path: **lets you set a custom log file path.
+A displayed tip reminds you to check the path exists and is writable. (Default path: /var/log/messages).
+ \\
+**Log To Remote System: **provides network support to the syslogd facility.
+Thus, messages can be forwarded from one node running syslogd to another running syslogd, where they'll be logged to disk. ((
 [[https://linux.die.net/man/8/syslogd|https://linux.die.net/man/8/syslogd]]
 ))
-**IP Address / Port:** In these fields, enter the IP address of the host to which syslog data will be directed, and the port over which data will be sent.
+ \\
-**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.
+**IP Address / Port:** the IP address of the host to receive syslog data, and the port on they are sent.
+ \\
+**Generate Marker:**  makes log files easier to read. Checking this causes "——MARK—–"  to be inserted into the log\\ at the specified interval.
+ \\
   * Disabled
@@ Line 34: / Line 55: @@
 **Events Logged:**
-  * Access Restriction - Checking this causes logging of Access Restriction events.
+ \\
-  * Cron - Causes Cron events to be logged.
-  * DHCP Client - Causes logging of DHCP IP addressing events.
+  * Access Restriction - causes Access Restriction events to be logged.
-  * NTP - Causes logging of Network Time Protocol events.
+  * Cron - causes Cron events to be logged.
-  * Scheduler - Causes logging of events configured in the Scheduler menu.
+  * DHCP Client - causes DHCP IP addressing events to be logged.
+  * NTP - causes Network Time Protocol events to be logged.
+  * Scheduler - causes events set in the Scheduler menu to be logged.
  \\
-**Minimum Log Level:**  In this menu, you select the minimum level of messages to be logged.
+**Minimum Log Level:**  selects the minimum level of messages to be logged.
-Here, "minimum" means that whichever option you select from the list, that level's messages and all those \\ higher in the list will be logged.
+"Minimum" means whichever option you select, that level's messages and all those above it in the list will be logged.
-  * Emergency - Only Emergency-level messages will be logged.
+ \\
-  * Alert - Messages categorized as Alert and higher will be logged.
-  * Critical - Messages categorized as Critical and higher will be logged.
+  * Emergency - only Emergency-level messages will be logged.
-  * Error - Messages of Error level or higher will be logged.
+  * Alert - messages categorized as Alert and higher will be logged.
-  * Warning - Messages of Warning level or higher will be logged.
+  * Critical - messages categorized as Critical and higher will be logged.
-  * Notice - Messages of Notice level or higher will be logged.
+  * Error - messages of Error level or higher will be logged.
-  * Info - Messages of Information level or higher will be logged.
+  * Warning - messages of Warning level or higher will be logged.
-  * Debug - Debug-level information and all other levels will be logged.
+  * Notice - messages of Notice level or higher will be logged.
+  * Info - messages of Information level or higher will be logged.
+  * Debug - debug-level information, all other levels will be logged.
  \\
-**Connection Logging: **
+**Connection Logging:**
+ \\
   * Inbound
-    * Disabled - Disables logging of incoming connections.
+    * Disabled - disables logging of incoming connections.
-    * If Blocked by Firewall - Logs incoming connection attempts blocked by the firewall.
+    * If Blocked by Firewall - logs incoming connection attempts blocked by the firewall.
-    * If Allowed by Firewall - Logs incoming connection attempts allowed by the firewall.
+    * If Allowed by Firewall - logs incoming connection attempts allowed by the firewall.
-    * Both - Logs all incoming connection attempts.
+    * Both - logs all incoming connection attempts.
   * Outbound
-    * Disabled - Disables logging of outgoing connections.
+    * Disabled - disables logging of outgoing connections.
-    * If Blocked by Firewall - Logs outgoing connection attempts blocked by the firewall.
+    * If Blocked by Firewall - logs outgoing connection attempts blocked by the firewall.
-    * If Allowed by Firewall - Logs outgoing connection attempts allowed by the firewall.
+    * If Allowed by Firewall - logs outgoing connection attempts allowed by the firewall.
-    * Both - Logs all outgoing connection attempts.
+    * Both - logs all outgoing connection attempts.
-  * Limit - Here, enter the maximum messages per minute to be logged in the system log. \\ Enter '0' for unlimited. (Default: 60).
+  * Limit - the maximum messages per minute to be logged in the system log. \\ Enter "0" for unlimited. (Default: 60).
 ===== Web Monitor =====
-Clicking **Enable >>** Takes you to the Administration/Logging page (including Syslog settings)
+**Enable >>** takes you to the //Administration///[[admin-log|Logging]] menu (and 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).
+**Monitor Web Usage:** enables/disables Web Monitoring. (Default: Disabled).
  \\
-[[https://wiki.freshtomato.org/lib/exe/detail.php?id=web_usage&media=pasted:20200521-200701.png|{{:pasted:20200521-200701.png?773}}]]
+**Monitor**: select the Device/s you wish to monitor.
  \\
+  * All Computers /Devices * - monitors all devices (Default).
+  * The following - monitors only devices entered here.
+  * All except - monitors all devices except those entered here.
  \\
-**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.
+[[https://wiki.freshtomato.org/lib/exe/detail.php?id=web_usage&media=pasted:20200521-200701.png|{{:pasted:20200521-200701.png?687}}]]
-**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)
+ \\
+**Number of Entries to remember**: the number of //Domains// visited and number of //Searches// to record in the log.
+Entering: "0" disables logging of domains / searches.
+Almost all sites and search engines nowadays use http**s** so not every domain can be logged, only those invoked with http. As all search engines use https logging of searches has become impossible, so this feature is not functional anymore.
+ \\
+**Daily Backup**: enables backup of Web Monitor logs to the default backup directory. (Default: Disabled).
+ \\
+**Clear Data After Backup**: empties the log file after a backup is performed. (Default: Disabled)
+ \\
-**Backup Directory**: This specifies where the backup files will be stored. (Default: /tmp).
+**Backup Directory**: specifies where backup files will be stored. (Default: /tmp).
  \\
-NOTE: Contents in the default (\tmp) folder are emptied ater a reboot. You might consider using USB/CIFS/JFFS storage as an alternative for more permanent storage.
+NOTE: The contents of the default "/tmp" folder are emptied on reboot. Consider using USB/CIFS/JFFS as permanent storage.
-===== Web Usage/Web Monitor Notes =====
+===== Web Usage/Web Monitor Notes and Troubleshooting =====
-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.
+Web usage **won't work properly** if the FreshTomato client monitored is running a direct TOR or VPN Internet connection. FreshTomato cannot monitor such connections since they are already encrypted. This can also include some IPv6 tunneling protocols, such as 6in4 Static tunnel.
  \\

FreshTomato Wiki

User Tools

Site Tools

Differences

Page Tools