Process flow run failures


A process flow may fail for a number of reasons - for example, if a mapped field in the source/destination system has changed unexpectedly; if authentication credentials for a connection have expired, or if shape configuration is incorrect.

You might notice the failure whilst observing real-time logs as a flow is run manually, or you might have received an email alert advising that an auto-triggered process flow failed to complete.

This guide summarises what to do in the event that a process flow fails.

When a process runs and fails, it's re-tried three times automatically before being stopped and logged as a failure.

Handling a process flow run failure

Step 1 Check the run logs for the process flow. Here you'll find detailed information associated with each step in the flow, so you can identify which shape caused the flow to fail.

If a process flow has failed at a connection step, consider the following:

  • Are the authentication credentials provided for the selected connector instance still current? If you need to update credentials, you can edit the instance.

  • Are all connection shape settings correct? For example, could the issue be related to a variable or parameter (either missing or defined incorrectly)?

  • Is the third-party system associated with your connector instance experiencing any issues?

  • Is the connector instance associated with a custom connector that was built by someone in your own organisation using connector builder? If yes, check that the data schema for the endpoint selected in your connection step is valid.

If you change credentials for an instance, those credentials will be updated in all process flows where that instance is defined.

Step 2 If the cause of the failure isn't obvious from the log details, check the payloads for each step in the flow to see if they are as expected. Payloads are available from the run logs page, via the view logs option for each step:

Step 3 If you've found the cause of the failure from the logs and need to update the process flow, access the process flow in question and make the required changes. OR If you haven't found the issue and need to investigate further, access the process flow in question and check the settings for each shape.

Step 4 Having updated the process flow, you may wish to run it manually to check that the issue is resolved or wait for the next scheduled run.

Last updated