Execution History

Every workflow run in BFF is persisted with full step-by-step detail. This gives you a complete audit trail of automated processes.

Viewing Runs

  1. Navigate to Workflows
  2. Open any workflow
  3. Click the “Runs” or “History” tab
  4. See a list of all executions

Run Statuses

StatusMeaning
RunningThe workflow is actively executing
Pending HumanWaiting for a human approval step
CompletedAll steps finished successfully
FailedA step encountered an error
CancelledThe run was manually cancelled

Step-Level Detail

Click into any run to see per-step information:

  • Step name and assignee
  • Status (completed, running, pending, failed)
  • Start and end times
  • Duration of execution
  • Output or errors from the step

Real-Time Monitoring

For active workflow runs:

  • The workflow visualization shows the current step highlighted
  • Status updates in real-time via WebSocket
  • Pending human steps show a notification badge
  • Failed steps show error details immediately

Troubleshooting Failed Runs

When a workflow run fails:

  1. Open the run detail view
  2. Find the failed step (marked in red)
  3. Review the error message
  4. Check if the assignee (human or AI) encountered an issue
  5. Fix the underlying problem
  6. Re-run the workflow if needed

Using History for Optimization

Review your workflow history to:

  • Identify bottleneck steps that take the longest
  • Find frequently failing steps that need better instructions
  • Track approval turnaround times for human-in-the-loop steps
  • Measure overall workflow efficiency

Tip: Regular review of workflow execution history helps you continuously improve your automated processes. Look for patterns in failures and slow steps.