Overview: This article provides step-by-step instructions to enable debug logging for Lithium components. Note: For AMS-related cases, please refer to the following article: Enabling Debug Logging for AMS.
Applicability: These instructions apply to all Lithium components except AMS.
Procedure to Enable Debug Logging:
Step 1: Update the rsyslog Configuration File
-
Open the
/etc/rsyslog.conf
file using your preferred text editor (e.g.,vi
,nano
, orvim
).sudo vi /etc/rsyslog.conf
-
Scroll to the end of the file and append the following line to enable debug logging:
*.debug /var/log/debug
-
Save and exit the file.
Step 2: Restart the rsyslog Service
-
Restart the rsyslog service to apply the changes:
sudo systemctl restart rsyslog
Step 3: Validate the rsyslog Status
-
Check the status of the rsyslog service to ensure it is running without issues:
systemctl status rsyslog
Ensure the service is active (running) and there are no errors in the output.
Verification: Once the debug logging is enabled, log files will start populating in /var/log/debug
. You can view these logs in real time using the following command:
sudo tail -f /var/log/debug
This will display live log entries as they are written to the file.
Important Notes:
-
This procedure should be performed during a maintenance window or during low-traffic periods to avoid disruption.
-
Ensure that you have sufficient disk space available in
/var/log/
as debug logs can grow rapidly. -
If you encounter issues with the rsyslog service, review the system journal for more information:
journalctl -u rsyslog
For issues related to enabling debug logging for AMS components, please refer to the following article: Enabling Debug Logging for AMS.
If you have any questions or need further assistance, please contact support.