翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Bedrock の証跡を表示してフローの各ステップを追跡する
<a name="flows-trace"></a>

フローを呼び出す際、*証跡*を表示して各ノードへの入力と出力を確認できます。証跡は、入力から最終的に返されるレスポンスまでのパスを追跡するのに役立ちます。証跡を使用すると、発生したエラーのトラブルシューティング、予期しない結果やパフォーマンスのボトルネックにつながるステップの特定、フローを改善する方法の検討を行うことができます。

証跡を表示するには、次の手順を実行します。
+ 「[Amazon Bedrock でフローをテストする](flows-test.md)」の**[コンソール]** タブの手順に従って、コンソールで、フロー呼び出しからのレスポンスで **[トレースを表示]** を選択します。
+ API で、[InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html) リクエストの `enableTrace` フィールドを `true` に設定します。レスポンスの各 `flowOutputEvent` は、`flowTraceEvent` と共に返されます。

各証跡イベントには、入力を受信したか出力を生成したノードの名前と、入力または出力が処理された日時が含まれます。証跡イベントのタイプの詳細を確認するには、次のタブを選択してください。

------
#### [ FlowTraceConditionNodeResultEvent ]

このタイプの証跡は、条件ノードで満たされる条件を識別し、呼び出し中にアクティブ化されたフローの分岐を識別するのに役立ちます。次の JSON オブジェクトは、条件ノードの結果について [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) がどのように表示されるかを説明しています。

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

------
#### [ FlowTraceNodeInputEvent ]

このタイプの証跡は、ノードに送信された入力を表示します。イベントがイテレーターノードの下流で、コレクターノードの上流にある場合、`iterationIndex` フィールドは、入力元の配列内の項目のインデックスを示します。次の JSON オブジェクトは、ノードへの入力に対する [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) がどのように表示されるかを説明しています。

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

------
#### [ FlowTraceNodeOutputEvent ]

このタイプの証跡は、ノードが生成した出力を表示します。イベントがイテレーターノードの下流で、コレクターノードの上流にある場合、`iterationIndex` フィールドは、出力元の配列内の項目のインデックスを示します。次の JSON オブジェクトは、ノードからの出力に対する [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) がどのように表示されるかを説明しています。

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

------