Monitor workflows
Pre-requisites: Created a workflow
Workflow Runs
A published workflow will be started automatically every time an App emits an event matching that Trigger. Each Workflow Run is unique and will have a dedicated timeline. The timeline of that run can be found in the Primer dashboard, alongside an overview of the workflow route that was taken. This can be used for validating that the workflow was set up correctly.
Workflow run status
Workflow Run status
A Workflow Run can have one of the following four statuses:| Status | Description |
|---|---|
Running | The workflow has started and is still running |
Waiting | The Workflow Run is waiting for an external event in order to be continued (e.g. shopper needs to complete authentication for 3DS) |
Completed | The run has reached the end of the configured workflow |
Failed | Something went wrong during the execution of the workflow or one of its actions. We recommend listening to the webhook event to be informed immediately when a workflow run fails. |
Workflow Run status vs payment status
When using Workflows to process payments, be aware that the payment status is completely decoupled from its run status.A workflow run marked as
Completed does not necessarily mean that the payment has been successfully authorized.Completed.
Similarly: a Workflow Run marked as Failed does not mean that the payment has failed. For this example, assume a workflow authorizing a payment and then sending a message to Slack. If the processor successfully authorizes the payment, the payment status will be Authorized and the workflow run will continue. However, if Slack is down and the message was not sent, then the workflow will be marked as Failed because it did not get to execute all expected steps.
Workflow Run details
Each Workflow Run comes with a detailed timeline. This timeline shows events that happened during the execution in chronological order. You can choose to reverse the order in which the timeline is displayed so that the most recent blocks are presented first.
Workflow timeline
- the set of Inputs and Outputs used by the trigger or action
- the API calls made by the trigger or action
- the Conditions met by the Conditions Utility (the ‘all other conditions’ block will show when none of the conditions were applicable)
Payment outputs
Workflow API calls
Workflow condition
For additional details on the Payments App, visit the Payments section of the dashboard.
The Payments timeline will give you additional insights on the steps a payment went through.
Metrics
The duration for each workflow run - and even for each individual block - is displayed on the Workflow Runs list, the timeline, and each block and it’s drawer. This way you know exactly how long any given step took. This is based on the time it took from the run start to when it finished and is not displayed for runs that are ongoing or in a waiting state.The displayed duration also includes any time that the workflow might have been put into a “waiting” state, for example by waiting for the user to complete an action like performing a 3D Secure authentication.