View a markdown version of this page

Amazon Bedrock AgentCore 에이전트의 관찰성 데이터 보기 - Amazon Bedrock AgentCore
Amazon CloudWatch에서 생성형 AI 관찰성을 사용하여 데이터 보기CloudWatch에서 다른 데이터 보기

Amazon Bedrock AgentCore 에이전트의 관찰성 데이터 보기

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

Amazon CloudWatch에서 생성형 AI 관찰성을 사용하여 데이터 보기

CloudWatch 생성형 AI 관찰성 페이지에는 AgentCore 에이전트 런타임에서 출력한 모든 서비스 제공 지표와 에이전트 코드에서 계측을 활성화한 경우 스팬 및 트레이스 파생 데이터가 표시됩니다. CloudWatch에서 관찰성 대시보드를 보려면 Amazon CloudWatch GenAi 관찰성 페이지를 엽니다.

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

CloudWatch에서 다른 데이터 보기

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

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

로그

  1. CloudWatch 콘솔을 엽니다.

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

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

    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를 포함할 수 있습니다.

트레이스 및 스팬

추적은 에이전트를 통한 요청 실행 경로에 대한 가시성을 제공합니다.

  • 위치: 에이전트 로그 그룹의 로그 spans 스트림(/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) 또는 공유 스팬 대상을 사용하는 에이전트의 default 로그 그룹의 aws/spans 로그 스트림입니다. 자세한 내용은 Amazon Bedrock AgentCore 런타임에서 호스팅되는 에이전트의 범위 대상을 참조하세요.

  • 를 통한 액세스: 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

AgentCore 관찰성 활성화에 설명된 대로 에이전트 코드를 계측하여 관찰성을 활성화한 경우 에이전트는 향상된 지표 형식(EMF)을 사용하여 CloudWatch로 전송되는 OTEL 지표를 자동으로 생성합니다.

  • 네임스페이스: bedrock-agentcore

  • 를 통한 액세스: CloudWatch Metrics 콘솔

  • 콘텐츠: 에이전트 코드 및 프레임워크에서 생성된 사용자 지정 지표

  • 자동 수집: 추가 코드 필요 없음 - ADOT 계측으로 생성됨

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