View a markdown version of this page

AgentCore에서 메모리 관찰성 데이터 생성 - Amazon Bedrock AgentCore
제공된 메모리 지표제공된 스팬 데이터제공된 로그 데이터

AgentCore에서 메모리 관찰성 데이터 생성

AgentCore 메모리 리소스 유형의 경우 AgentCore는 기본적으로 Amazon CloudWatch에 지표를 출력합니다. 또한 AgentCore는 활성화된 경우 기본 스팬 및 로그 집합을 출력합니다. 스팬 및 로그 활성화에 대한 자세한 내용은 AgentCore 런타임, 메모리, 게이트웨이, 내장 도구 및 자격 증명 리소스에 대한 관찰성 활성화를 참조하세요.

에이전트 메모리 스토어에 제공된 관찰성 데이터에 대해 자세히 알아보려면 다음 섹션을 참조하세요.

제공된 메모리 지표

AgentCore 메모리 리소스 유형은 기본적으로 다음 지표를 제공합니다.

Latency

요청 수신과 최종 응답 토큰 전송 사이에 경과된 총 시간입니다. 요청의 전체 end-to-end 처리를 나타냅니다.

Invocations

데이터 영역 및 컨트롤 플레인에 대한 총 API 요청 수입니다. 또한이 지표는 메모리 수집 이벤트 수를 추적합니다.

시스템 오류

AWS 서버 측 오류가 발생하는 호출 수입니다.

사용자 오류

클라이언트 측 오류가 발생하는 호출 수.

오류

데이터 영역 및 컨트롤 플레인에서 API 요청을 처리하는 동안 발생하는 총 오류 수입니다. 또한이 지표는 메모리 수집 중에 발생하는 총 오류를 추적합니다.

제한

시스템이 제한된 호출 수. 제한된 요청은 호출, 오류 및 사용자 오류로 계산됩니다.

생성 수

생성된 메모리 이벤트 및 메모리 레코드 수를 계산합니다.

제공된 스팬 데이터

관찰성을 향상시키기 위해 AgentCore는 이벤트와 이벤트가 생성하거나 액세스하는 메모리 간의 관계를 추적하는 구조화된 스팬을 제공합니다. 이 스팬 데이터를 활성화하려면 에이전트 코드를 계측해야 합니다. 자세한 내용은 Amazon Bedrock AgentCore 리소스에 관찰성 추가를 참조하세요.

이 범위 데이터는 CloudWatch Logs 및 CloudWatch Application Signals에서 전체적으로 사용할 수 있습니다. 관찰성 데이터 보기에 대한 자세한 내용은 Amazon Bedrock AgentCore 에이전트의 관찰성 데이터 보기를 참조하세요.

다음 표에서는 스팬이 생성되는 작업과 캡처된 각 스팬의 속성을 정의합니다.

작업 이름 범위 속성 설명

CreateEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

메모리 세션 내에 새 이벤트를 생성합니다.

GetEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

기존 메모리 이벤트를 검색합니다.

ListEvents

memory.id , session.id , event.id , actor.id , throttled , error , fault

세션 내의 이벤트를 나열합니다.

DeleteEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

메모리에서 이벤트를 삭제합니다.

RetrieveMemoryRecords

memory.id , namespace , throttled , error , fault

지정된 네임스페이스에 대한 메모리 레코드를 검색합니다.

ListMemoryRecords

memory.id , namespace , throttled , error , fault

사용 가능한 메모리 레코드를 나열합니다.

제공된 로그 데이터

AgentCore는 주요 AgentCore 메모리 리소스 프로세스를 모니터링하고 문제를 해결하는 데 도움이 되는 구조화된 로그를 제공합니다. 이 로그 데이터를 활성화하려면 에이전트 코드를 계측해야 합니다. 자세한 내용은 Amazon Bedrock AgentCore 리소스에 관찰성 추가를 참조하세요.

AgentCore는 CloudWatch Logs, Amazon S3 또는 Firehose 스트림에 로그를 출력할 수 있습니다. CloudWatch Logs 대상을 사용하는 경우 이러한 로그는 기본 로그 그룹 /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} 또는 /aws/vendedlogs/ 로 시작하는 사용자 지정 로그 그룹에 저장됩니다. 자세한 내용은 AgentCore 런타임, 메모리, 게이트웨이, 내장 도구 및 자격 증명 리소스에 대한 관찰성 활성화를 참조하세요.

DeleteMemory 작업이 호출되면 삭제 프로세스의 시작 및 완료에 대한 로그가 생성됩니다. 해당 삭제 오류 로그에는 호출이 실패한 이유에 대한 인사이트가 제공됩니다.

또한 장기 메모리 생성 프로세스, 즉 추출 및 통합의 다양한 단계에 대한 로그를 제공합니다. 새로운 단기 메모리 이벤트가 제공되면 AgentCore는 응답에서 주요 개념을 추출하여 새로운 장기 메모리 레코드의 형성을 시작합니다. 이러한 메모리가 생성되면 기존 메모리 레코드와 통합되어 고유한 메모리의 통합 저장소를 생성합니다.

각 워크플로가 새 메모리 형성을 모니터링하는 데 어떻게 도움이 되는지 알아보려면 다음 분석을 참조하세요.

추출 로그

  • 추출 처리 시작 및 완료

  • 성공적으로 추출된 메모리 수

  • 입력 이벤트 역직렬화 또는 처리 오류

통합 로그:

  • 통합 처리 시작 및 완료

  • 통합이 필요한 메모리 수

  • 메모리 추가 및 업데이트 성공/실패

  • 관련 메모리 검색 상태

다음 표에서는 다양한 메모리 리소스 워크플로가 로그 본문 자체와 함께 로그 필드를 사용하여 요청별 정보를 제공하는 방법을 자세히 설명합니다.

워크플로 이름 로그 필드 설명

추출

resource_arn, event_timestamp, memory_strategy_id, 네임스페이스, actor_id, session_id, event_id, requestId, isError

수신 대화를 분석하여 새 메모리를 생성합니다.

통합

resource_arn, event_timestamp, memory_strategy_id, 네임스페이스, session_id, requestId, isError

추출된 메모리를 기존 메모리와 결합합니다.