

# Memory
<a name="Memory"></a>

에이전트가 어떤 방식으로 컨텍스트 정보를 저장, 검색, 사용하여 개인화된 경험을 제공하는지 숙지하시기 바랍니다. Amazon Bedrock AgentCore 메모리에 대한 자세한 내용은 [AI 에이전트에 메모리 추가](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html) 섹션을 참조하세요. 메모리 관찰성에는 3가지 주요 모니터링 영역이 포함됩니다.
+ **메모리** - 메모리 스토리지 및 검색 패턴 모니터링
+ **메모리 세션** - 개별 세션 내 메모리 사용량 모니터링
+ **트레이스 보기** - 메모리 작업에 대한 세부 트레이스 정보에 액세스

![메모리 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Memory.png)


단기 또는 장기 메모리에 대해 숙지하려면 [AI 에이전트에 메모리 추가](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html) 섹션을 참조하세요.

**세부 정보 보기**를 선택하여 그래프에서 메모리 지표를 확인합니다.

![메모리 지표 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Memory_metrics.png)


**메모리**에서 계정과 연결된 모든 메모리를 볼 수 있습니다. 메모리 **이름**을 선택하여 메모리 세부 정보를 봅니다.

![메모리 지표 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Memory_details.png)


**메모리 세부 정보** 페이지에 다음과 같은 탭이 표시됩니다.
+ **개요** - 선택한 메모리 리소스에 대한 포괄적인 메모리 성능 지표 및 사용 패턴이 표시됩니다.
  + **연결된 에이전트** - 메모리를 사용하여 에이전트를 볼 수 있습니다. 에이전트 개요 페이지를 보려면 **에이전트/엔드포인트**를 선택합니다.
  + **메모리 API 간접 호출** - 스토리지, 검색, 업데이트 요청을 비롯하여 메모리 작업에 대해 발생한 총 API 직접 호출 수입니다. 이 지표는 메모리 시스템 사용량 및 용량 계획을 추적하는 데 도움이 됩니다.
  + **추출된 메모리 레코드** - 에이전트 상호 작용을 통해 성공적으로 추출되고 처리된 메모리 레코드 수입니다. 여기에는 에이전트가 개인화를 위해 저장하는 컨텍스트 정보, 사용자 기본 설정, 대화 기록이 포함됩니다.
  + **서버 오류** - 메모리 작업 도중 발생한 시스템 오류 횟수입니다. 이 수치가 높을 경우 조사가 필요한 메모리 스토리지 또는 검색 시스템에 인프라 문제가 발생했을 가능성이 있습니다.
  + **클라이언트 오류** - 잘못된 메모리 요청, 잘못된 데이터 또는 권한 문제로 인한 오류입니다. 클라이언트 오류율이 높으면 에이전트 메모리 통합 또는 데이터 형식 지정에 문제가 발생했을 가능성이 있습니다.
  + **스로틀링**- 허용된 트랜잭션 제한을 초과하여 스로틀링된 메모리 요청 수입니다. 이 지표를 모니터링하여 메모리 액세스 패턴에 최적화가 필요한지 또는 서비스 할당량에 조정이 필요한지 여부를 확인합니다.
  + **지연 시간** - 스토리지 및 검색 요청을 비롯한 메모리 작업에 대한 응답 시간입니다. P50, P90, P99 지연 시간을 추적하여 성능 병목 현상을 식별하고 메모리 액세스 패턴을 최적화합니다.
+ **메모리 세션** - 에이전트 상호 작용에서 발생한 단기 메모리가 포함된 세션을 볼 수 있습니다. **메모리 세션**에서 **세션 ID**를 선택하여 세션 대시보드를 봅니다.
+ **트레이스** - 에이전트에 대한 트레이스를 표시합니다. **트레이스**에서 **트레이스 ID**를 선택하여 특정 메모리를 간접적으로 호출하는 트레이스를 확인합니다. 트레이스 대시보드를 사용하여 에이전트 메모리 사용량 및 최종 응답을 자세히 살펴볼 수 있습니다.

**참고**  
**메모리 세션** 및 **트레이스** 탭의 사용 방식과 필드 항목은 **기본 제공 도구**, **게이트웨이**, **메모리**, **ID** 관찰성 전반에 걸쳐 유사합니다. 해당 필드에 대한 자세한 내용은 [Code Interpreter 도구](Built-in-tools.md#Code-interpreter-tool) 섹션을 참조하세요.