Log manager

The log manager allows you to view the Matrix system log files and is located under the System management folder in the asset tree.

To view the system logs, go to the Details screen of the log manager and click on the Monitor button for the list of log messages you wish to view.

5 0 0 log manager asset

Details screen

The Details screen of the log manager allows you to view the system log files.

5 0 0 known logs section log manager

There are several system log files within Matrix that may appear in this section:

Error

All PHP errors are logged in this log file. This will include the system or database access errors at the top of a user’s screen within Matrix.

Search

All search queries and results for the Matrix search page are logged in this log file.

System

All Matrix system-generated messages are logged in this log file. For example, the creation of new assets, attribute changes, and configuration changes.

Asset cache

When the sq_conf_debug configuration setting is enabled in the system’s main.inc file, 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.

Cron errors

All scheduled job errors are logged in this log file.

Form ecommerce order

Logs the usage of ecommerce form page assets.

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 determine any noticeable performance issues on the system quickly.

Only the log files that have been created within 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 here.

Monitor logs

To view a log, click on the Monitor button. The messages of that log will appear in the Log monitor section below.

5 0 0 log monitor section log manager

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 example 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 currently displayed messages. 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 of a specific log in the list. The selected log will be downloaded to your computer as a text file.

Log file rotation

The log files for the system can be found in the /data/private/logs directory.

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 1, and the existing file named <logname>.1 is overwritten, and the cycle continues.

© 2015- Squiz Pty Ltd