기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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
        }
    }
}
```

------