Log Manager
The Log Manager
The Log Manager allows you to view the Squiz Matrix system log files and is located under the System Management Folder in the Asset Map, as highlighted in the figure to the right.
To view the system logs, go to the Details screen of the Log Manager and click on the Monitor button for the list of messages you wish to view.
Bookmarks to the headings on this page:
Details Screen
The Details screen of the Log Manager allows you to view the system log files. The Known Logs section of the Details screen is shown in the figure below.
The Known Logs section of the Details screen
There are a number of system log files within Squiz Matrix that may appear in this section. These are as follows:
- error: all PHP errors are logged in this log file. This will include the system or database access errors that appear at the top of a user’s screen within Squiz Matrix.
- search: all search queries and results for the Squiz Matrix Search Page are logged in this log file.
- system: all Squiz Matrix generated messages are logged in this log file. This may include the creation of new assets, attribute changes and/or configuration changes.
-
asset_cache: when the SQ_CONF_DEBUG configuration setting is enabled in the system's main.inc file, Squiz Matrix will log internal caching information in this log file, specifically any internal cache objects that were not cleared correctly. This log
is used for development purposes only.
For more information on the SQ_CONF_DEBUG configuration setting, refer to the Annotated main.inc chapter in the Server Administrator manual. - cron_errors: all cron job errors are logged in this log file.
- funnelback: generated after reindexing the Funnelback Manager. This log file contains information on the funnelback engine and logs funnelback errors on the system.
- performance: performance alerts are logged in this log file. This includes when a listing asset, such as an Asset Listing Page, attempts to list over 1000 items on a single page. This log is used by system administrators to quickly determine any obvious performance issues on the system.
Only the log files that have been created within Squiz Matrix will be listed in the Log Manager. If the system has not created a particular log file, for example, if your system has not received any performance alerts, this file will not yet exist and thus will not appear in the Log Manager.
Monitor Logs
To view a log, click on the Monitor button. The list will appear in the Log Monitor sections, as shown in the figure below.
The Log Monitor section displaying the System log
Within the Log Monitor section, the following information is shown:
- Log: this field shows the name of the log being monitored. For example, in the figure shown above the system logs are being monitored.
- Loaded: this field shows the last time that the list of messages was last updated. By default, this list will be updated every 30 seconds. You can force the section to refresh by clicking on the Refresh Now button and you can disable the refresh by clicking the Disable button.
- Max Rows: this field allows you to change the number of messages that are currently being displayed. By default, 50 rows will be displayed. You can select to show either 10, 50, 100, 500 or 1000 rows. Once you select a value from the list, the screen will be updated.
- Auto-Refresh: by default, the list of messages will be updated every 30 seconds. To stop the refresh from happening, click on the Disable button. To turn the refresh back on, click on the Enable button. If you Disable the refresh, you can update the list by clicking on the Refresh Now button.
- Refresh Interval: this field allows you to change the time frame between each refresh of the list of messages. By default, the refresh will happen every 30 seconds. You can select to refresh the list every 15 seconds, 30 seconds, 1 minute or 5 minutes.
- Refresh Now: click this button to force the list of messages to be refreshed.
Download Logs
To download a log, click on the Download button. The selected log will be downloaded to your computer as a text file. An example of a downloaded log is shown in the figure below.
A downloaded System log
Log File Rotation
The log files for the system can be found in the directory /data/private/logs. These logs are rotated once every 24 hours. When the log is first created, it is given the name <logname>.1. The next day, the new log is rotated to <logname>.2, and so on until <logname>.10 is reached. The rotation index is then set back to one, and the existing file with name <logname>.1 is overwritten and the cycle continues.