General Logging Settings
From this section of the Logging page, you can specify the length of your logfile, as well as a file location to write your logfile to (see also logging)
- Log Length: This is the length of the internal log message buffer. This buffer is used to show the log messages in the web interface.
- Log Filename: To request that the system write log messages to a file, specify the file name here (you will need to create the folder on your drive if you would like the file to be saved to a specific folder). A dollar sign must be used in the filename string. The system replaces the dollar sign with the current day and automatically generates a new file daily. This ensures that the log files do not become too large over time. The setting log-$.txt creates a log file with the name log-yyyy-mm-dd.txt, where yyyy is the year, mm is the month, and dd is the date.
If the Log Filename setting does not contain a path (but includes only the filename string: log-$.txt), the system writes the log file to the PBX working folder.
Be sure to delete old log files from time to time so that your file system does not get overloaded with too much logging information. Warning: Be sure to lower the log levels once the system is running, especially when you write the log messages to a file. Sooner or later, you will get a "hard disk full" error, which is a severe situation because the system will not be able to save runtime data.
- Syslog server IP address: The PBX has a built-in syslog client that sends log messages to the syslog server (a syslog server is a server that implements the syslog protocol to collect log messages). For Releases 4.5 and earlier, this field takes an IP address only (the PBX expects the syslog server to be on default port 514). For Releases later than 4.5, a port number can be specified in this field (e.g., 192.168.1.200:555). If the port is omitted, the default port 514 will be used.