ARNscopeDocs

AWS Step Functions

Last updated 16 October 2026

ARNscope follows a Step Functions run while it happens. A running execution opens on a graph that updates as each state finishes, and any state shows its input, its output, every attempt with its error and the logs its Lambda function or ECS task wrote, beside the graph. A timeline and the full event history cover the same run. Stop and redrive always ask first.

A narrated tour of about ninety seconds, with captions: a run followed live, a state's input and output, a retry, Live Tail, the timeline and events, a failed run and redrive. Sample data.

State machines and runs

Open Step Functions in ARNscope and choose the profile and region. The list shows every state machine; Express workflows are marked EXP. Select one to open it.

Tab What it shows
Executions The runs, newest first, with a summary strip and a chart of recent runs
Definition The definition as a graph (click a state for its settings) or as JSON
Details ARN, type, execution role, revision, logging level and log groups, X-Ray tracing

Above the executions, a strip shows the success rate, failed and running runs, the median and p95 duration and the slowest run. Recent runs draws each run as a bar: its height is the duration, its colour the outcome. Click a bar to open that run. Filter the list by status (Running, Succeeded, Failed, Timed out, Aborted) or by name.

The executions: the summary strip, recent runs by duration and outcome, and the status filters.

The first 100 runs show at once; older pages load in the background, up to 2,000, and Load older reads further back. Status filters and the name filter work on what is loaded.

Express workflows keep no execution history in Step Functions, so their Executions tab says where their runs are logged instead. You can still start one.

A run, live

Open a run and it shows on the graph. Each state is coloured by what happened to it: Succeeded, Caught, Failed, Running or not run, and the path the run took is drawn in. Parallel branches and Map processors sit inside their state. Each state shows its time, how many times it ran, and ↻ with the number of retries. Zoom with ⌘-scroll or the buttons, drag to pan, and Fit graph to see it all.

While the run is going, ARNscope reads it again every five seconds (not while the window is hidden), so states light up as they finish. It opens on the state that is running, or the one that failed.

The analyst approves, and the run moves on into the Map: each item runs as its own iteration.

A strip above the graph sums up the run: its duration, the states and transitions so far, the retries, the slowest state, and the largest payload against Step Functions’ 256 KB limit.

A state’s input, output and attempts

Click a state for its details: how long it took, when it was entered, its attempts, the size of its input and output, then the input and output themselves and the state’s definition, with its target, retries and catchers. A state that ran more than once, such as a Map iteration or a state in a loop, has a Visit menu to pick which run of it to show.

A state's input and output, and how long it took.

A retried state lists every attempt with its outcome, its time, the backoff before it and the error that ended it. An error shows its name, its message and, for Lambda and Python errors, the stack trace.

A retry after a timeout: every attempt, the backoff between them, and the error with its stack trace.

A state’s logs and Live Tail

The Logs tab beside Details shows what the state wrote:

The state ran Logs shown
A Lambda function The function’s log group (/aws/lambda/<name>), for the time the state ran
An ECS task Each container’s awslogs stream for the task, merged by time
Anything else The state machine’s own log group, filtered to this execution, when logging is on

Pick another source from the menu, such as the state machine log, and filter the lines as you type. Up to 1,000 lines are read.

The Lambda function's logs for a step, beside the graph.

While a state is still running, Live tail streams new lines as they are written, with CloudWatch Logs Live Tail. It stops when you leave the Logs tab or the page, keeps the newest 2,000 lines, and says when CloudWatch is sampling a busy group. Live Tail is billed by CloudWatch per minute.

Live Tail on a step that is still running.

Timeline, events, input and output

Timeline puts every state on one time axis: each visit is a bar, red ticks mark failed attempts that were retried, and the last columns give each state’s total time and share of the run. Parallel and Map states include the time of the states inside them. Click a row to open that state.

Every state, attempt and retry on one axis, so slow steps stand out.

Events is the full execution history, with the time from the start, the type, the state and a detail column. Filter it to Failures, Transitions or Tasks, or by text; click an event for its JSON, with embedded JSON strings expanded. Input & output shows the execution’s own input and output.

The event history, filtered to failures, with an event's JSON.

A failed run

A failed, timed-out or aborted run opens on the state that broke. A banner above the graph names it and shows the error, its message and the stack trace when there is one.

A failed run opens on the state that broke.

Stop, redrive and run again

These change things in your account, so each one asks first:

Redrive asks before anything runs, then follows the run.

A run whose error was caught and that ended in a Fail state would fail again at once if redriven, with no step rerun. ARNscope says so in the bar, offers Run again instead, and keeps Redrive anyway for when you mean it.

A run that ended in a Fail state gets a warning instead.

Buttons your role cannot use are disabled, with the reason from the IAM permission check.

Permissions

What Actions
List state machines states:ListStateMachines
Definition and details states:DescribeStateMachine
Executions states:ListExecutions
A run states:DescribeExecution, states:DescribeStateMachineForExecution, states:GetExecutionHistory
Logs logs:FilterLogEvents (Lambda and state machine logs); ecs:DescribeTaskDefinition and logs:GetLogEvents (ECS tasks)
Live Tail logs:StartLiveTail, logs:DescribeLogGroups
Start, run again states:StartExecution
Stop states:StopExecution
Redrive states:RedriveExecution

Limitations