Learn how to troubleshoot your integration in Cortex XSOAR.
When troubleshooting integrations, do the following:
Use the Test button in the integration instance.
Verify the integration settings. Check settings such as usernames, URLs, and passwords.
Download the debug log file and review its contents.
In the following example, you receive a 401 unauthorized error code after testing the integration.
Click Run Test & Download Debug Log, to download the debug file locally. You can verify what server the URL request is being forwarded to and any other reasons as to why you received this error code. The 401 unauthorized error code usually relates to invalid error credentials, expired tokens, or incorrect API settings.
Enable verbose or debug-level logging on the integration.
Review the integration logs ( → → → ).
You can sort the logs by things such as source instance, command, and log level. You can also export the file
Note
If an integration instance consistently encounters API rate limits when running on the tenant, consider configuring the instance to run on an engine to change the source of the outbound traffic.
If you are unable to fix the integration, contact Customer Support for further assistance.