View a markdown version of this page

관찰성 및 비용 제어 - Amazon Bedrock AgentCore

관찰성 및 비용 제어

이 페이지에서는 하네스 모니터링, 실행 비용 제어, 리소스 태그 관리를 다룹니다.

관찰성

모든 하네스 호출은 CloudWatch의 AgentCore 관찰성을 통해 트레이스, 로그 및 지표를 자동으로 생성합니다. 모델 호출, 도구 호출, 메모리 작업, 쉘 명령: 각 단계는 타이밍 및 페이로드 세부 정보와 함께 표시됩니다. 추가 구성이 없습니다. 추적은 첫 번째 호출부터 사용할 수 있습니다.

AWS CLI/boto3

트레이스, 로그 및 지표는 하네스 실행 역할을 통해 CloudWatch로 흐릅니다. AgentCore 관찰성 대시보드에서 보거나 CloudWatch Logs 및 X-Ray APIs.

추적이 표시되기 전에 CloudWatch에서 트랜잭션 검색을 활성화합니다(계정당 1회). 설정 세부 정보는 AgentCore 관찰성 시작하기를 참조하세요.

AgentCore CLI
# Stream logs agentcore logs --harness research-agent # Filter agentcore logs --harness research-agent --since 1h --level error # List recent traces agentcore traces list --harness research-agent # Get a specific trace agentcore traces get <trace-id> --harness research-agent

자세히 알아보기: 관찰성 개요 · 지표 · 원격 측정

CloudTrail

하네스 작업은 AWS CloudTrail에 관리 이벤트(컨트롤 플레인) 및 데이터 이벤트(데이터 플레인)로 기록됩니다. CloudTrail에서 하네스 리소스는 하네스별 유형이 아닌 AWS::BedrockAgentCore::Runtime 리소스 유형 아래에 나타납니다. Harness는 AgentCore 런타임에 대한 관리형 추상화이며, CloudTrail 이벤트는 일관성을 위해 기본 런타임 리소스를 반영합니다.

모든 하네스 CloudTrail 이벤트는 resources.type =를 사용합니다AWS::BedrockAgentCore::Runtime. 이벤트 이름은 다음과 같습니다.

  • CreateHarness, UpdateHarness, DeleteHarness, GetHarness, ListHarnesses (관리 이벤트)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (데이터 이벤트)

참고

데이터 영역 작업은 기본 런타임 APIInvokeAgentRuntime와 일치하는 및 로 CloudTrailInvokeAgentRuntimeCommand에 표시됩니다. resources.ARN 필드에는 컨트롤 플레인 이벤트에 대한 하네스 ARN과 데이터 플레인 이벤트에 대한 런타임 ARN이 포함됩니다.

제한으로 비용 제어

런어웨이 에이전트가 리소스를 번스루하지 않도록 하드 캡을 설정합니다.

  • maxIterations - 호출당 추론/작업 주기. 기본값은 75입니다.

  • timeoutSeconds - 단일 간접 호출에 대한 벽시계 제한 시간입니다. 기본값은 3600입니다.

  • maxTokens - 호출당 토큰 예산입니다. 기본 해당 사항 없음.

  • idleRuntimeSessionTimeout - 유휴 microVM이 웜 상태를 유지하는 시간입니다. 기본값은 900입니다.

  • maxLifetime - microVM 세션의 최대 수명입니다. 기본값은 28800입니다.

모든 제한은 선택 사항이며 서비스 기본값을 사용하려면 생략합니다. 하네스는 AgentCore 런타임에서 지원하므로 하네스 호출에도 런타임 서비스 할당량이 적용됩니다. 자세한 내용은 AgentCore harness Service QuotasAgentCore Runtime Service Quotas 참조하세요.

AWS CLI/boto3
aws bedrock-agentcore-control update-harness \ --harness-id "MyHarness-UuFdkQoXSL" \ --max-iterations 50 \ --timeout-seconds 1800 \ --max-tokens 8192

또는에서 maxIterations, timeoutSeconds또는를 전달하여 단일 호출maxTokens에 대해 재정의합니다invoke_harness.

AgentCore CLI

기본값 설정:

agentcore add harness --name bounded-agent \ --max-iterations 50 --timeout 1800 --max-tokens 8192 \ --truncation-strategy sliding_window \ --idle-timeout 600 --max-lifetime 14400 agentcore deploy

--truncation-strategy 플래그는 sliding_window 또는를 허용합니다summarization. --idle-timeout--max-lifetime 플래그는 수명 주기 제한을 초 단위로 설정합니다.

단일 호출에서 재정의:

agentcore invoke --harness bounded-agent --max-iterations 20 --harness-timeout 600 \ "Quick lookup: what's the weather in Seattle?"

Tags

비용 할당 및 액세스 제어를 위해 하네스에 태그를 적용합니다.

AWS CLI/boto3
aws bedrock-agentcore-control create-harness \ --harness-name "MyHarness" \ --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole" \ --tags '{"team": "platform", "environment": "staging"}'
AgentCore CLI

에서 태그 설정harness.json:

{ "tags": { "team": "platform", "environment": "staging" } }

를 실행agentcore deploy하여 적용합니다.

태그는 배포된 CloudFormation 리소스로 흐릅니다.