Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Track each step in your flow by viewing its trace in Amazon Bedrock

Focus mode
Track each step in your flow by viewing its trace in Amazon Bedrock - Amazon Bedrock

When you invoke a flow, you can view the trace to see the inputs to and outputs from each node. The trace helps you track the path from the input to the response that it ultimately returns. You can use the trace to troubleshoot errors that occur, to identify steps that lead to an unexpected outcome or performance bottleneck, and to consider ways in which you can improve the flow.

To view the trace, do the following:

  • In the console, follow the steps in the Console tab at Test a flow in Amazon Bedrock and choose Show trace in the response from flow invocation.

  • In the API, set the enableTrace field to true in an InvokeFlow request. Each flowOutputEvent in the response is returned alongside a flowTraceEvent.

Each trace event includes the name of the node that either received an input or yielded an output and the date at time at which the input or output was processed. Select a tab to learn more about a type of trace event:

FlowTraceConditionNodeResultEvent

This type of trace identifies which conditions are satisfied for a condition node and helps you identify the branch or branches of the flow that are activated during the invocation. The following JSON object shows what a FlowTraceEvent looks like for the result of a condition node:

{ "trace": { "conditionNodeOutputTrace": { "nodeName": "string", "satisfiedConditions": [ { "conditionName": "string" }, ... ], "timestamp": timestamp } } }
FlowTraceNodeInputEvent

This type of trace displays the input that was sent to a node. If the event is downstream from an iterator node but upstream from a collector node, the iterationIndex field indicates the index of the item in the array that the input is from. The following JSON object shows what a FlowTraceEvent looks like for the input into a node.

{ "trace": { "nodeInputTrace": { "fields": [ { "content": { "document": JSON object }, "nodeInputName": "string" }, ... ], "nodeName": "string", "timestamp": timestamp, "iterationIndex": int } } }
FlowTraceNodeOutputEvent

This type of trace displays the output that was produced by a node. If the event is downstream from an iterator node but upstream from a collector node, the iterationIndex field indicates the index of the item in the array that the output is from. The following JSON object shows what a FlowTraceEvent looks like for the output from a node.

{ "trace": { "nodeOutputTrace": { "fields": [ { "content": { "document": JSON object }, "nodeOutputName": "string" }, ... ], "nodeName": "string", "timestamp": timestamp, "iterationIndex": int } } }

This type of trace identifies which conditions are satisfied for a condition node and helps you identify the branch or branches of the flow that are activated during the invocation. The following JSON object shows what a FlowTraceEvent looks like for the result of a condition node:

{ "trace": { "conditionNodeOutputTrace": { "nodeName": "string", "satisfiedConditions": [ { "conditionName": "string" }, ... ], "timestamp": timestamp } } }
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.