Debug logs allow Salesforce to record the actions performed by a specific user. These logs are an essential troubleshooting tool and help the support team identify the root cause of errors or unexpected system behavior.

Follow the steps below to enable and collect a debug log.

Step 1: Open Debug Logs

1. Log in to Salesforce.
2. Click the ⚙️ Gear icon in the top-right corner and select Setup.
3. In the Quick Find box, search for Debug Logs.
4. Select Debug Logs from the results.

Step 2: Create or Update a Trace Flag

To start collecting logs, Salesforce requires a Trace Flag for the user whose actions you want to monitor.

1. Click New.
2. Configure the following fields:

• Traced Entity Type: User
• Traced Entity Name: Select the user experiencing the issue.
• Start Date: Set this to the current date and time.
• Expiration Date: Set this to approximately 30–60 minutes after the start time, depending on how long you need to capture the issue.
• Debug Level: Select SFDC_DevConsole (Log Type = Developer_Log).

3. Click Save.

Note: If the user already has an existing Trace Flag, you do not need to create a new one. Simply edit the existing Trace Flag and update the Start Date and Expiration Date so that it covers the period when you will reproduce the issue.

Step 3: Reproduce the Issue

Once the Trace Flag is active:

1. Perform the same actions that caused the error or unexpected behavior.
2. Complete the process until the issue occurs.

Salesforce will automatically capture the user's activity in the debug log.

Step 4: Download the Debug Log

After reproducing the issue:

1. Return to Setup → Debug Logs.
2. Locate the newly generated log.
3. Click View to inspect the log if required, or click Download to save it to your computer.

Step 5: Send the Log to Support

Attach the downloaded debug log to your support case or email it to the support team. Including the approximate time the issue occurred and the steps you performed will help the support team investigate the issue more efficiently.

Tips

• Enable the Trace Flag before reproducing the issue; otherwise, Salesforce will not capture the activity.
• Keep the Trace Flag active only for the required duration, as debug logging can generate large log files.
• If multiple attempts are needed, ensure the Trace Flag has not expired before trying again.