Execution Details page – Interface overview
You can find the details for all your in-progress and past state machine executions for both Standard and Express Workflows on the Execution Details page. If you specified an execution ID while starting your execution, this page is titled with that execution ID. Otherwise, it’s titled with the unique execution ID that Step Functions automatically generates for you.
Besides the execution metrics, the Execution Details page provides the following options for managing your state machine and its execution:
Button | Choose this button to: |
---|---|
Edit state machine | Edit your state machine's Amazon States Language definition. |
New execution | Start a new execution of your state machine. |
Actions | Provides the following options to choose from:
|
Viewing executions started with a version or alias
You can also view the executions started with a version or an alias in the Step Functions console. For more information, see Listing executions for versions and aliases.
The Execution Details console page contains the following sections:
Execution summary
The Execution summary section appears at the top of the Execution Details page. This section provides you with an overview of the execution details of your workflow. This information is divided between the following three tabs:
- Details
-
Shows information, such as the execution's status, ARN, and timestamps for execution start and end time. You can also view the total count of State transitions that occurred while running the state machine execution. You can also view the links for X-Ray trace map and Amazon CloudWatch Execution Logs if you enabled tracing or logs for your state machine.
If your state machine execution was started by another state machine, you can view the link for the parent state machine on this tab.
If your state machine execution was redriven, this tab displays redrive related information, for example Redrive count.
- Execution input and output
-
Shows the state machine execution input and output side-by-side.
- Definition
-
Shows the state machine's Amazon States Language definition.
Error message
If your state machine execution failed, the Execution Details page displays an error message. Choose Cause or View step details in the error message to view the reason for execution failure or the step that caused the error.
If you choose View step details, Step Functions highlights the step that caused the error in the Step details, Graph view, and Table view tabs. If the step is a Task, Map, or Parallel state for which you've defined retries, the Step details pane displays the Retry tab for the step. Additionally, if you've redriven the execution, you can see the retries and redrive execution details in the Retries & redrives tab of the Step details pane.
From the Recover dropdown button on this error message, you can either redrive your unsuccessful executions or start a new execution. For more information, see Redriving executions.
View mode
The View mode section contains two different visualizations for your state machine. You can choose to view a graphic representation of the workflow, a table outlining the states in your workflow, or a list of the events associated with your state machine's execution:
Note
Choose a tab to view its contents.
Step details
The Step details section opens up on the right when you choose a state in the Graph view or Table view. This section contains the following tabs, which provide you in-depth information about the selected state:
- Input
-
Shows the input details of the selected state. If there is an error in the input, it is indicated with a on the tab header. In addition, you can view the reason for the error in this tab.
You can also choose the Advanced view toggle button to see the input data transfer path as the data passed through the selected state. This lets you identify how your input was processed as one or more of the fields, such as
InputPath
,Parameters
,ResultSelector
,OutputPath
, andResultPath
, were applied to the data. - Output
-
Shows the output of the selected state. If there is an error in the output, it is indicated with a on the tab header. In addition, you can view the reason for the error in the this tab.
You can also choose the Advanced view toggle button to see the output data transfer path as the data passed through the selected state. This lets you identify how your input was processed as one or more of the fields, such as
InputPath
,Parameters
,ResultSelector
,OutputPath
, andResultPath
, were applied to the data. - Details
-
Shows information, such as the state type, its execution status, and execution duration.
For
Task
states that use a resource, such as Amazon Lambda, this tab provides links to the resource definition page and Amazon CloudWatch logs page for the resource invocation. It also shows values, if specified, for theTask
state'sTimeoutSeconds
andHeartbeatSeconds
fields.For
Map
states, this tab shows you information regarding the total count of aMap
state's iterations. Iterations are categorized as Failed, Aborted, Succeeded, or InProgress. - Definition
-
Shows the Amazon States Language definition corresponding to the selected state.
- Retry
-
Note
This tab appears only if you've defined a
Retry
field in your state machine'sTask
orParallel
state.Shows the initial and subsequent retry attempts for a selected state in its original execution attempt. For the initial and all the subsequent failed attempts, choose the next to Type to view the Reason for failure that appears in a dropdown box. If the retry attempt succeeds, you can view the Output that appears in a dropdown box.
If you've redriven your execution, this tab header displays the name Retries & redrives and displays the retry attempt details for each redrive.
- Events
-
Shows a filtered list of the events associated with the selected state in an execution. The information you see on this tab is a subset of the complete execution event history you see in the Events table.
Events
The Events table displays the complete history for the selected execution as a list of events spanning multiple pages. Each page contains up to 25 events. This section also displays the total event count, which can help you determine if you exceeded the maximum event history count of 25,000 events.
By default, the results in the Events table are displayed in ascending order based on the Timestamp of the events. You can change the execution event history's sorting to descending order by clicking on the Timestamp column header.
In the Events table, each event is color-coded to indicate its execution status. For example, events that failed appear in red. To view additional details about an event, choose the next to the event ID. Once open, the event details show the input, output, and resource invocation for the event.
In addition, in the Events table, you can apply filters to limit the execution event history results that are displayed. You can choose properties such as ID, or Redrive attempt. For more information, see Tutorial: Examining state machine executions using the Step Functions console.