Topic
Whether you're troubleshooting issues on your own or with the guidance of Nintex Support, generating ULS logs for Nintex is one of the best methods to identifying underlying causes of issues that are occurring within your environment. Below is a step by step guide on how to configure and generate the most effective ULS logs to identify Nintex related issues.
Instructions
1. Navigate to Central Administration > Monitoring > Configure diagnostic logging > Check box for all categories starting with 'Nintex'. For example:
Nintex Common
Nintex External Connection Components
Nintex Live
Nintex Forms
Nintex Workflow 20xx
Note: The 'Nintex' categories will vary between different versions of SharePoint.
2. Expand SharePoint Foundation and select the check box for Legacy Workflow Infrastructure.
3. Scroll to the bottom of the page, locate the dropdown menu titled "Least critical event to report to the trace log" and select 'Verbose'. Click ‘Ok’
4. After the logging has been configured, replicate the error or behavior. Take note of the time of your replication as you will need this for step 6.
5. On one of your SharePoint servers, open a SharePoint Management Shell as Administrator
6. Use the Merge-SPLogFile cmdlet to capture logs from the time frame when the issue occurred, ensuring that the -StartTime is 1 minute before the issue occurred, and the -EndTime is 1 minute after the issue occurred.
Example:
To collect log information for an error condition occurring at 1:00 p.m. (13:00) on January 14, 2023, enter the following:
Merge-SPLogFile -Path "C:\Nintex Issue.log" -Overwrite -StartTime "01/14/2023 12:59" -EndTime "01/14/2023 13:01"
Additional Information
To use Merge-SPLogFile in PowerShell, run Add-PSsnapin Microsoft.SharePoint.PowerShell
If the request for ULS logs came from Nintex Support:
1. Please zip the files as this will compress the log file significantly.
2. If the file is less than 5MB, send it using normal email provided with your case.
3. If file is more than 5MB, please request an upload link from Nintex Support.
Related Links
Download the ULS Viewer from Microsoft:
https://www.microsoft.com/en-us/download/details.aspx?id=44020