Enabling Debug Logging for Lithium Components

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

1. Open the /etc/rsyslog.conf file using your preferred text editor (e.g., vi, nano, or vim).

   sudo vi /etc/rsyslog.conf

2. Scroll to the end of the file and append the following line to enable debug logging:

   *.debug /var/log/debug

3. Save and exit the file.

Step 2: Restart the rsyslog Service

1. Restart the rsyslog service to apply the changes:

   sudo systemctl restart rsyslog

Step 3: Validate the rsyslog Status

1. 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

 

If you have any questions or need further assistance, please contact support.