FlowOS Automation HubPlain-English product documentation

Before you start

  • At least one seeded or safe test execution.
  • Permission to view workflow executions.
Read an execution trace before retrying anything diagram
Read an execution trace before retrying anything — a text description is included inside the diagram and in the surrounding section.

#Read the trace in a fixed order

  1. Confirm workspace, workflow, version, source event, and time.
  2. Read node status and timing in path order.
  3. Inspect only the context needed to explain each decision.
  4. Match connector or notification delivery evidence to the action.
  5. Identify whether the run completed, paused, failed, or was safely ignored.

#Replay only after checking side effects

Compare the original and replay contexts, node outputs, and branch paths. If the original may have reached an external system, verify its delivery record or idempotency key before replay. A replay is a new auditable run, not an edit to history.

#Keep durable work supervised

Queue workers execute workflows and notifications after web requests end. The scheduler starts scheduled triggers, resumes waits, performs health checks, and runs optional periodic tasks. Monitor backlog, dead letters, repeated connector failures, stuck approvals, and due waits.

Read path evidence in order. Capture details
A replay records differences without rewriting the original. Capture details
Operational signals expose backlog and repeated failures. Capture details

#Common mistakes

  • Retrying before determining whether the external action succeeded.
  • Reading raw context as a substitute for authorization.
  • Running queue workers without process supervision.

#Verify the result

  • The source event and workflow version are known.
  • External delivery status is known.
  • Replay duplicate risk is resolved.
  • Workers and scheduler are monitored.
Enlarged documentation screenshot