GET EVENTS step error in Flow Designer

Problem

The Get Alerts step in the Flow Designer seems to not work every time, and will occasionally display one of the following error messages:

Caught an error in step "Get Alerts"
Script failed with message: JavaObject[org.springframework.web.client.ResourceAccessException: I/O error on GET request for "https://example.xmatters.com/api/xm/1/events": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out (org.springframework.web.client.ResourceAccessException)]

Error: Could not get Alert IDs. xMatters API returned [403] Access Denied

Environment

All versions of xMatters

Resolution

These errors are caused by different underlying issues:

• Timeout / Read timed out: This happens because the query is timing out. The query performance depends on whether it's using a wildcard or exact match.

• 403 Access Denied: This occurs when the account used to run the flow does not have the required REST/API permissions to call the xMatters API.

To resolve timeout issues, if the property value you are returning is a unique value, you should set the Exact Property Value Match to TRUE. (The default property value for the Get Events step Exact Property Value Match is FALSE.)

To resolve 403 Access Denied issues, make sure the flow runs with an account that has the appropriate API permissions. For example, add the REST Web Service User role to the user running the flow, or configure the flow to use a properly privileged service account.

For a detailed guide on setting up the Get Events step, see Set up a Get Events step.