# Amazon Bedrock AgentCore 에이전트의 관찰성 데이터 보기
<a name="observability-view"></a>

에이전트에서 관찰성을 구현한 후 CloudWatch 콘솔 생성형 AI 관찰성 페이지와 CloudWatch Logs 모두에서 수집된 지표와 트레이스를 볼 수 있습니다. 에이전트에 대한 지표를 보는 방법을 알아보려면 다음 섹션을 참조하세요.

## Amazon CloudWatch에서 생성형 AI 관찰성을 사용하여 데이터 보기
<a name="observability-view-console"></a>

CloudWatch 생성형 AI 관찰성 페이지에는 AgentCore 에이전트 런타임에서 출력한 모든 서비스 제공 지표와 에이전트 코드에서 계측을 활성화한 경우 스팬 및 트레이스 파생 데이터가 표시됩니다. CloudWatch에서 관찰성 대시보드를 보려면 [Amazon CloudWatch GenAi 관찰성](https://console.aws.amazon.com/cloudwatch/home#gen-ai-observability) 페이지를 엽니다.

CloudWatch에서 생성형 AI 관찰성을 사용하면 데이터의 그래프 및 기타 시각화뿐만 아니라 오류 분석, 트레이스 시각화 등이 포함된 맞춤형 대시보드를 볼 수 있습니다. 에이전트의 개별 세션 및 추적 데이터를 보는 방법을 포함하여 CloudWatch에서 생성형 AI 관찰성을 사용하는 방법에 대한 자세한 내용은 [Amazon CloudWatch 사용 설명서의 Amazon Bedrock AgentCore 에이전트](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AgentCore-Agents.html)를 참조하세요. *Amazon CloudWatch *

## CloudWatch에서 다른 데이터 보기
<a name="observability-view-cw"></a>

서비스 제공 지표 및 스팬은 계측된 에이전트 코드가 출력하는 지표와 함께 CloudWatch에서도 볼 수 있습니다.

이 데이터를 보려면 다음 섹션을 참조하세요.

### 로그
<a name="observability-view-cw-logs"></a>

1. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/home)을 엽니다.

1. 왼쪽 탐색 창에서 **로그**를 확장하고 **로그 그룹을** 선택합니다.

1. 검색 필드를 사용하여 에이전트, 메모리 또는 게이트웨이 리소스의 로그 그룹을 찾습니다.

   AgentCore 에이전트 로그 그룹의 형식은 다음과 같습니다.
   +  **표준 로그** - stdout/stderr 출력
     +  **위치**: /aws/bedrock-agentcore/runtimes/<agent\_id>-<endpoint\_name>/[runtime-logs] <UUID>
     +  **포함**: 런타임 오류, 애플리케이션 로그, 디버깅 문
     +  **사용 예**:
       + print("Processing request... ") \# 표준 로그에 표시됨
       + logging.info("요청이 성공적으로 처리됨") \# 표준 로그에 표시됨
   +  **OTEL 구조화된 로그** - 세부 작업 정보
     +  **위치**: /aws/bedrock-agentcore/runtimes/<agent\_id>-<endpoint\_name>/otel-rt-logs
     +  **포함**: 실행 세부 정보, 오류 추적, 성능 데이터
     +  **자동 수집**: 추가 코드 필요 없음 - ADOT 계측으로 생성됨
     +  **이점**: 로그를 관련 추적에 연결하는 상관관계 IDs를 포함할 수 있습니다.

### 트레이스 및 스팬
<a name="observability-view-cw-spans"></a>

추적은 에이전트를 통한 요청 실행 경로에 대한 가시성을 제공합니다.
+ 위치: 에이전트 로그 그룹의 로그 `spans` 스트림(`/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>`) 또는 공유 스팬 대상을 사용하는 에이전트의 `default` 로그 그룹의 `aws/spans` 로그 스트림입니다. 자세한 내용은 [Amazon Bedrock AgentCore 런타임에서 호스팅되는 에이전트의 범위 대상](observability-configure.md#observability-configure-unified-traces)을 참조하세요.
+ 를 통한 액세스: CloudWatch 트랜잭션 검색 콘솔
+ 요구 사항: CloudWatch 트랜잭션 검색을 활성화해야 합니다.

추적은 다음을 자동으로 캡처합니다.
+ 에이전트 호출 시퀀스
+ 프레임워크 구성 요소와의 통합(LangChain 등)
+ LLM 호출 및 응답
+ 도구 호출 및 결과
+ 오류 경로 및 예외

서비스 간 분산 추적의 경우 표준 HTTP 헤더를 사용할 수 있습니다.
+  AWS X-Ray 형식: `X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1` 
+ W3C 형식: `traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01` 

트레이스를 보려면:
+ CloudWatch 콘솔로 이동
+ 왼쪽 탐색에서 **트랜잭션 검색을** 선택합니다.
+ 서비스 이름 또는 기타 기준을 기준으로 필터링
+ 세부 실행 그래프를 보려면 추적을 선택합니다.

### Metrics
<a name="observability-view-cw-metrics"></a>

[AgentCore 관찰성 활성화에 설명된 대로 에이전트 코드를 계측하여 관찰성을 활성화](observability-configure.md#observability-configure-builtin)한 경우 에이전트는 향상된 지표 형식(EMF)을 사용하여 CloudWatch로 전송되는 OTEL 지표를 자동으로 생성합니다.
+ 네임스페이스: `bedrock-agentcore` 
+ 를 통한 액세스: CloudWatch Metrics 콘솔
+ 콘텐츠: 에이전트 코드 및 프레임워크에서 생성된 사용자 지정 지표
+ 자동 수집: 추가 코드 필요 없음 - ADOT 계측으로 생성됨

에이전트가 내보낸 지표 외에도 AgentCore 서비스는 표준 서비스 지표를 CloudWatch에 게시합니다. 이러한 지표 목록은 [AgentCore에서 생성한 런타임 관찰성 데이터를](observability-runtime-metrics.md) 참조하세요.