AgentCore에서 생성한 내장 도구 관찰성 데이터
관찰성 도구 지표
AgentCore는 코드 인터프리터 및 브라우저 도구에 대해 다음과 같은 기본 제공 지표를 제공합니다. 기본 제공 도구 지표는 1분 간격으로 일괄 처리됩니다. AgentCore 도구에 대한 자세한 내용은 Amazon Bedrock AgentCore 코드 해석기를 사용하여 코드 실행 및 데이터 분석과 Amazon Bedrock AgentCore 브라우저를 사용하여 웹 애플리케이션과 상호 작용을 참조하세요.
호출 도구:
- Invocations
-
데이터 영역 API에 대한 총 요청 수입니다. 각 API 호출은 요청 페이로드 크기 또는 응답 상태에 관계없이 하나의 호출로 계산됩니다.
- 제한
-
허용된 TPS(초당 트랜잭션 수) 또는 할당량 제한을 초과하여 서비스에 의해 제한된 요청 수입니다. 이러한 요청은 HTTP 상태 코드 429와 함께 ThrottlingException을 반환합니다.
- SystemErrors
-
요청 처리 중에 발생한 서버 측 오류 수입니다.
- UserErrors
-
잘못된 요청으로 인한 클라이언트 측 오류 수입니다. 이를 해결하려면 사용자 작업이 필요합니다.
- Latency
-
서비스가 요청을 수신하는 시점과 첫 번째 응답 토큰 전송을 시작하는 시점 사이의 경과 시간입니다. 초기 응답 시간을 측정하는 데 중요합니다.
도구 세션 생성:
- Invocations
-
데이터 영역 API에 대한 총 요청 수입니다. 각 API 호출은 요청 페이로드 크기 또는 응답 상태에 관계없이 하나의 호출로 계산됩니다.
- 제한
-
허용된 TPS(초당 트랜잭션 수) 또는 할당량 제한을 초과하여 서비스에 의해 제한된 요청 수입니다. 이러한 요청은 HTTP 상태 코드 429와 함께 ThrottlingException을 반환합니다.
- SystemErrors
-
요청 처리 중에 발생한 서버 측 오류 수입니다.
- UserErrors
-
잘못된 요청으로 인한 클라이언트 측 오류 수입니다. 이를 해결하려면 사용자 작업이 필요합니다.
- Latency
-
서비스가 요청을 수신하는 시점과 첫 번째 응답 토큰 전송을 시작하는 시점 사이의 경과 시간입니다. 초기 응답 시간을 측정하는 데 중요합니다.
- 지속 시간
-
도구 세션 기간(작업이 CodeInterpreterSession/BrowserSession이 됨).
브라우저 사용자 인수:
- TakerOverCount
-
인수한 총 사용자 수
- TakerOverReleaseCount
-
제어를 해제하는 총 사용자 수
- TakerOverDuration
-
사용자의 인수 기간
리소스 사용량 지표 및 로그
Amazon Bedrock AgentCore 기본 제공 도구는 런타임 리소스에 대한 CPU 및 메모리 소비 지표를 포함하여 포괄적인 리소스 사용량 원격 측정을 제공합니다.
참고
리소스 사용 데이터는 최대 60분 지연될 수 있으며 지표마다 정밀도가 다를 수 있습니다.
판매 지표
기본적으로 Bedrock AgentCore 기본 제공 도구는 1분 해상도로 계정 수준 및 도구 수준에 대한 지표를 제공합니다. Amazon CloudWatch 집계 및 지표 데이터 보존은 표준 Amazon CloudWatch 데이터 보존 정책을 따릅니다. 자세한 내용은 https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric 참조하십시오.
| 이름 | 측정 기준 | 설명 |
|---|---|---|
|
CPUUsed-vCPUHours |
서비스, 서비스, 리소스 |
리소스 및 계정 수준에서 사용할 수 있는 vCPU-시간 단위의 총 가상 CPU 사용량입니다. 리소스 추적 및 예상 결제 가시성에 유용합니다. |
|
MemoryUsed-GBHours |
서비스, 서비스, 리소스 |
리소스 및 계정 수준에서 사용할 수 있는 GB-시간 단위로 사용된 총 메모리 양입니다. 리소스 추적 및 예상 결제 가시성에 유용합니다. |
차원 설명
-
서비스 - AgentCore.CodeInterpreter 또는 AgentCore.Browser
-
리소스 - 기본 제공 도구 ID
계정 수준 지표는 Amazon CloudWatch Bedrock AgentCore 관찰성 콘솔의 기본 제공 도구 탭에서 사용할 수 있습니다. 콘솔의 대시보드에는 메모리 사용량 그래프와 사용량 지표에서 생성된 CPU 사용량 그래프가 포함됩니다. 이 그래프는 리전의 계정에서 선택한 도구 유형의 모든 도구에 대한 총 리소스 사용량을 나타냅니다.
도구 수준 지표는 Amazon CloudWatch Bedrock AgentCore 관찰성 콘솔의 도구 페이지에서 사용할 수 있습니다. 콘솔의 대시보드에는 메모리 사용량 그래프와 사용량 지표에서 생성된 CPU 사용량 그래프가 포함됩니다. 그래프는 선택한 도구의 모든 세션에서 총 리소스 사용량을 나타냅니다.
참고
원격 측정 데이터는 모니터링 목적으로 제공됩니다. 실제 결제는 측정된 사용량 데이터를 기반으로 계산되며 집계 타이밍, 조정 프로세스 및 측정 정밀도로 인해 원격 측정 값과 다를 수 있습니다. 신뢰할 수 있는 요금은 AWS 결제 명세서를 참조하세요.
판매 로그
Amazon Bedrock AgentCore 기본 제공 도구는 세션 수준 사용량 원격 측정에 대해 벤딩 로그를 1초 단위로 활성화할 수 있는 기능을 제공합니다. 각 로그 레코드에는 1초의 리소스 사용량 데이텀이 포함됩니다. 현재 지원되는 지표는 다음과 같습니다.
-
Code Interprefer codeInterpreter.vcpu.hours.used 및 codeInterpreter.memory.gb_hours.used
-
브라우저 브라우저.vcpu.hours.used 및 브라우저.memory.gb_hours.used
각 리소스 사용량 데이텀은 로그 레코드에서 다음 스키마를 사용합니다.
코드 해석기
| 로그 유형 | 로그 필드 | 설명 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, codeInterpreter.vcpu.hours.used, codeInterpreter.memory.gb_hours.used |
세션 수준 리소스 추적을 위한 리소스 사용 로그입니다. |
브라우저
| 로그 유형 | 로그 필드 | 설명 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
세션 수준 리소스 추적을 위한 리소스 사용 로그입니다. |
로그 활성화에 대한 자세한 내용은 Amazon Bedrock AgentCore 리소스에 관찰성 추가를 참조하세요. 이러한 로그는 구성된 대상(AWS LogGroup, Amazon S3 또는 Amazon Kinesis Firehose)에 표시됩니다.
Amazon CloudWatch Bedrock AgentCore 관찰성 콘솔의 기본 제공 도구 세션 페이지에서 이러한 로그에서 생성된 리소스 사용량 지표를 볼 수 있습니다. 지표 보기 환경을 최적화하려면 오른쪽 상단의 선택기를 사용하여 원하는 시간 범위를 선택하여 특정 CPU 및 메모리 사용량 데이터에 초점을 맞춥니다.
참고
원격 측정 데이터는 모니터링 목적으로 제공됩니다. 실제 결제는 측정된 사용량 데이터를 기반으로 계산되며 집계 타이밍, 조정 프로세스 및 측정 정밀도로 인해 원격 측정 값과 다를 수 있습니다. 신뢰할 수 있는 요금은 AWS 결제 명세서를 참조하세요.
제공된 스팬 데이터
관찰성을 향상시키기 위해 AgentCore는 기본 제공 도구 APIs에 대한 가시성을 제공하는 구조화된 스팬을 제공합니다. 이 스팬 데이터를 활성화하려면 내장 도구 리소스에서 관찰성을 활성화해야 합니다. 단계 및 세부 정보는 Amazon Bedrock AgentCore 리소스에 관찰성 추가를 참조하세요. 이 범위 데이터는 aws/spans 로그 그룹의 전체 in AWS CloudWatch Logs에서 사용할 수 있습니다. 다음 표는 스팬이 생성되는 작업과 캡처된 각 스팬의 속성을 정의합니다.
코드 인터프리터
| 작업 이름 | 범위 속성 | 설명 |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
코드 인터프리터 세션을 시작합니다. |
|
StopCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
코드 인터프리터 세션을 중지합니다. |
|
InvokeCodeInterpreter |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
입력 코드를 사용하여 코드 인터프리터를 호출합니다. |
|
CodeInterpreterSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
StopCodeInterpreterSession이 호출되지 않고 세션 시간이 초과되면 코드 인터프리터 세션을 만료합니다. |
-
toolsession.id - 도구 세션의 ID
-
session_duration_s - 세션이 종료되기 전 초 단위의 세션 기간
브라우저
| 작업 이름 | 범위 속성 | 설명 |
|---|---|---|
|
StartBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
브라우저 세션을 시작합니다. |
|
StopBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
브라우저 세션을 중지합니다. |
|
ConnectBrowserAutomationStream |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
브라우저 자동화 스트림에 연결합니다. |
|
BrowserSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
StopBrowserSession이 호출되지 않고 세션 시간이 초과되면 코드 인터프리터 세션이 만료됩니다. |
애플리케이션 로그 데이터
AgentCore는 에이전트 런타임 호출 및 세션 수준 리소스 소비에 대한 가시성을 확보하는 데 도움이 되는 구조화된 애플리케이션 로그를 제공합니다. 이 로그 데이터는 에이전트 리소스에서 관찰성을 활성화할 때 제공됩니다. 단계 및 세부 정보는 Amazon Bedrock AgentCore 리소스에 관찰성 추가를 참조하세요. AgentCore는 CloudWatch Logs, Amazon S3 또는 Firehose 스트림에 로그를 출력할 수 있습니다. CloudWatch Logs 대상을 사용하는 경우 이러한 로그는 에이전트의 애플리케이션 로그 또는 자체 사용자 지정 로그 그룹에 저장됩니다.
| 로그 유형 | 로그 필드 | 설명 |
|---|---|---|
|
애플리케이션_로그 |
timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload, response_payload |
추적 필드, 요청 및 응답 페이로드를 포함하는 InvokeCodeInterpreter용 애플리케이션 로그 |
