Troubleshooting Integration Agent errors

Question

My Integration Agent log has a number of errors. What can I do to narrow the problem down?

Environment

All versions of xMatters Integration Agent

Answer

Before contacting support, try the following:

• Run the iadmin get-status command to verify the connection status of your agent.

• Check the IntegrationAgent.txt log file (in the /logs folder) for relevant errors.

• Narrow down if this is a startup issue for the service, a heartbeat issue to the xMatters server, an integration-specific problem, or an SSL certificate issue.

• If configuration issues are suspected, review the iaconfig.xml file in the /conf folder.

• Note the exact error message text from the log and identify the related Workflow or Alert ID (if the error appears to be tied to a specific workflow or alert).

If you are still having trouble finding a solution, log a support ticket. Include a support zip file along with your request to help with further troubleshooting.

We have detailed documentation for managing and troubleshooting the xMatters Agent here.