Skip to content

Monitor running workflows

Every request that enters a workflow becomes an instance you can follow from start to finish. This is where you answer “where has this request got to, and why has it stopped?”

Required role: Administrator.

  1. Go to Approvals → Instances.
  2. Filter by status, or search by request, resource, or workflow.
  3. Open the instance you are investigating.
  4. Read the Execution Timeline to see which steps have run, who was assigned, and how long each took.
  5. Open Execution Logs for the detail behind a step that failed.
  6. Select View on Canvas to see the same route as a diagram, with the current position marked.
The Workflow Instances list with counts of 13 total, 2 running, 9 completed and 0 failed, over rows mixing running, completed and cancelled instances with who started each one and how long it has taken.

The counts across the top — total, running, completed, and failed — are the fastest health check you have. A rising failed count is a configuration problem, not a people problem.

OptionDescription
IDThe instance’s own reference.
WorkflowThe route it is following.
ResourceWhat the request is about, in readable terms.
StatusPending, running, completed, failed, cancelled, or suspended.
Initiated ByWho raised it.
Started / DurationWhen it began and how long it has been running. A running instance counts up live.
OptionDescription
Execution SummaryThe resource, start and completion times, duration, and how many steps of the total have completed.
Execution TimelineEvery step in order with its type, duration, assignee, outcome, and whether it met or breached its deadline.
Execution LogsThe detailed record behind the timeline, filterable to one step.
ContextThe data the request carried, which is what the conditions were evaluated against.

Example: Priya Raman opens a promotion instance that has not moved for two days. The timeline shows the Finance step waiting on Daniel Okonkwo with its deadline breached, and the context shows the grade that sent it down the Finance branch. Both questions — where and why — are answered on one screen.

View on Canvas shows the route as a read-only diagram that refreshes while the instance is running, with each step coloured by state: completed, in progress, waiting, failed or breached, and not reached.

Use it when the route branches. A timeline tells you what happened; the diagram tells you which path was taken.

OptionDescription
CancelStops the workflow and cancels every pending or waiting step under it. Available while an instance is pending, running, suspended, or failed.
SuspendPauses a running instance.
ResumeRestarts a suspended instance from where it paused.
RetryAvailable on a failed instance, to run it again after the cause has been fixed.

Cancelling asks for a reason, and the reason is stored on the instance. Write a real one: cancellation is the intervention most likely to be questioned later.

Cancelling an instance stops the approval route. It does not undo anything the route had already caused to happen at an earlier step.

An instance can be exported as data, or downloaded as an audit document that sets out the whole route and every decision on it in readable form. That document is what to produce when an auditor asks who approved something and when.

A completed instance settles the request in the section that owns it. A failed one usually points at the route rather than the request — check the step that failed, fix it in a new version, and remember that requests already running stay on the version they started under.