Automation · Workflows

Workflow Error Tracking Patterns

When a workflow fails, the question is always 'which step, on which record, and why?' Error tracking is capturing enough context to answer that without re-running anything.

John Kihiu12 min read

Automation fails quietly. A workflow that processes a thousand records can fail on thirty of them, and if you are only watching for the whole run to crash, you will never notice. Error tracking for workflows is about capturing each failure with enough context to understand and fix it — and grouping them so thirty failures of one kind read as one problem, not thirty.

Capture the full run context

An error message alone is nearly useless in a workflow — "400 Bad Request" from step four tells you nothing about which record or run. Capture the whole context of the failure:

With that, a failure is diagnosable from the log; without it, every error becomes a re-run-and-hope investigation. The record id in particular is what lets you answer "who was affected" — the first question anyone asks.

Group by step and cause

Raw error streams overwhelm. Group failures by workflow, step, and error signature so a systemic problem surfaces as one growing count rather than a thousand individual alerts. "Step 4 has failed 240 times with 'customer not found' in the last hour" is an actionable signal; 240 separate log lines are noise you will scroll past.

Data errors vs system errors

Separate the two, because they route to different people. A system error — a downstream is down, credentials expired — is an ops problem, often transient, usually retryable. A data error — a required field is missing, a reference does not resolve — is a data-quality problem that a retry will never fix and that belongs in front of whoever owns the data. Mixing them means ops chases data bugs and real outages get lost in the noise.

Every tracked error needs an owner and a next step

Error tracking that no one acts on is just a growing table. For each error class, decide up front: retry automatically, alert ops, or send to a human review queue. An error with a defined destination gets resolved; an error with none accumulates until it becomes a mystery backlog.

Good workflow error tracking captures full run context, groups by step and cause, splits data problems from system problems, and routes each to an owner. That turns "the automation is flaky" into a ranked, attributable list of specific failures you can actually work through.

John Kihiu
Acumatica ERP Developer · Laravel Engineer

Independent software engineer in Nairobi specialising in Acumatica customisations, Laravel backends, and tax fiscalisation integrations across East and Southern Africa.