Log Files
Log Browser assists in troubleshooting issues with your websites by parsing the web server logs and displaying relevant warnings and error messages in the staXscale Dashboard.
On Linux, the information from the following log files is displayed by default:
Apache access (access_log). This log records all HTTP requests processed by the Apache web server.
Apache ssl access (access_ssl_log). This log records all HTTPS requests processed by the Apache web server.
Apache error (error_log). This log contains diagnostic information and records any errors that the Apache web server encounters in processing requests.
nginx access (proxy_access_log). This log records all HTTP requests processed by the nginx proxy web server.
nginx ssl access (proxy_access_ssl_log). This log records all HTTPS requests processed by the nginx proxy web server.
nginx error (proxy_error_log). This log contains diagnostic information and records any errors that the nginx proxy web server encounters in processing requests.
In addition, you can add any custom log file from your web site directory to track it in the Log Browser.
Access Log Browser
To access the Log Browser, go to Websites and Domains > Logs. You will be presented with a list of messages gathered from the logs. By default, the Log Browser displays messages present in the monitored logs at the moment of opening. Click Refresh to refresh the list with messages added after opening the Log Browser. Alternatively, click Start real-time updates to have new messages continuously added to the list.
To select the logs from which you want to view messages, click the filter icon and select the desired logs from the menu.
Manage Log Files
To view all the messages in a log, go to Websites and Domains > Logs > Manage log files. The list of all tracked log files will be displayed.
Click a log file name to view the file content directly in the Log Browser. Click the open icon next to a log file to open it for viewing in a separate window, or the download icon to download it.
To save disk space, you can enable log rotation that automatically compresses and/or deletes outdated website log files. To set up log rotation, go to Websites and Domains > Logs > Manage log files > Log Rotation.
You can delete log files that have been rotated. Log files that have not yet been rotated cannot be removed.
Add a Custom Log File
You can add any custom log file from your web site directory to track its changes in the Log Browser. Click the Add Custom Log button on the Manage Log Files page. The tree with your web site folders will be displayed. Select the file that you want to add to the Log Browser and click OK.
Note: Only plain text files can be selected. Your custom log file should have timestamps for each log entry to be properly displayed and parsed correctly.
The selected log file will be displayed in the list of managed log files.
If you no longer want to monitor this custom log file, click the remove icon next to it. This removes the file from the list of files available in the Log Browser but does not remove the file from your file system.
You can also open a text file in the Log Browser directly from the File Manager, using the Open in Log Browser option.
When you open a log file from the File Manager in the Log Browser, it is not yet added to the list of logs viewed in the Log Browser on a permanent basis. To add the file to the Log Browser, click the Add to Log Browser as Custom file button.
Note: Log rotation is not available for custom log files.
