Problem:
When Amperity runs into an error in its workflow that must be addressed by a user the workflow will stop and return an error to the user. This error will inform the user of the issue that has been encountered and provide a few different options for resolving the issue.
More information on workflow errors related to ingest can be found here: <INSERT ACTUAL LINK ONCE PUBLISHED>
Solution:
To review the error you can click "View workflow" in the email you received about the error. Alternatively you can access all workflows via the "Workflows" page in Amperity and select the workflow you are interested in.
Every workflow error will have at least two possible resolutions.
- Retry the workflow from the failed step without making any changes
- Retry the workflow from the failed step taking into account any configuration changes that have occurred
Retrying the workflow without making any changes is the option you should select if the error is transient and has been resolved outside of Amperity. For instance a destination service was down for maintenance and Amperity could not send it data. Or data was not available for Amperity to ingest from a source service.
If the error is caused by a problem with the configuration in Amperity then you can modify the necessary configuration and retry the workflow using the updated configuration. This may be necessary in cases like a source file location changing. The courier configuration would need to be updated and then run again. Or if the credentials for a destination needed to be updated.
In the example below simply retrying the workflow will still cause a failure. There is an error in the SQL code that needs to be resolved before this workflow will complete. The user will need to resolve this error and restart the workflow using the updated configuration.
Depending on the error there may be additional resolution options that are displayed. For example the workflow error below is caused by an issue with the credential that has been provided. By selecting the option to "Update Credential" Amperity will guide you through the process of updating the credential associated with this orchestration and retrying the workflow.
Selecting "Continue" will take you to the next page that provides specific instructions on how to update the credential. Once the credential is updated you can then select "Resolve" to restart the workflow from the failed step using the new credential.
You can find more information on specific resolutions by visiting the docs site: https://docs.amperity.com/reference/workflows.html#available-resolutions