기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CloudWatch 지표를 사용하여 Amazon Bedrock Agents 모니터링
<a name="monitoring-agents-cw-metrics"></a>

다음 테이블에서는 Amazon CloudWatch 지표로 모니터링할 수 있는 Amazon Bedrock Agents에서 제공하는 런타임 지표를 설명합니다.

**런타임 지표**


****  

| 지표 이름 | 단위 | 설명 | 
| --- | --- | --- | 
| InvocationCount | SampleCount | API 작업에 대한 요청 수 | 
| TotalTime | 밀리초 | 서버가 요청을 처리하는 데 걸린 시간 | 
| TTFT | 밀리초 | 첫 번째 토큰까지의 시간 지표. invokeAgent 또는 invokeInlineAgent 요청에 대해 스트리밍 구성이 활성화된 경우 내보내짐 | 
| InvocationThrottles | SampleCount | 시스템이 제한된 호출 수. 스로틀링한 요청 및 기타 간접 호출 오류는 간접 호출 또는 오류로 간주되지 않습니다. | 
| InvocationServerErrors | SampleCount |  AWS 서버 측 오류가 발생하는 호출 수 | 
| InvocationClientErrors | SampleCount | 클라이언트 측 오류가 발생하는 간접 호출 수 | 
| ModelLatency | 밀리초 | 모델의 지연 시간 | 
| ModelInvocationCount | SampleCount | 에이전트가 모델에 요청한 요청 수 | 
| ModelInvocationThrottles | SampleCount | Amazon Bedrock 코어가 스로틀링한 모델 간접 호출 수입니다. 스로틀링한 요청 및 기타 간접 호출 오류는 간접 호출 또는 오류로 간주되지 않습니다. | 
| ModelInvocationClientErrors | SampleCount | 클라이언트 측 오류가 발생하는 모델 간접 호출 수 | 
| ModelInvocationServerErrors | SampleCount |  AWS 서버 측 오류가 발생하는 모델 호출 수 | 
| InputTokenCount | SampleCount | 모델에 입력되는 토큰 수입니다. | 
| outputTokenCount | SampleCount | 모델에서 출력된 토큰 수입니다. | 

아래 테이블을 기반으로 CloudWatch 콘솔에서 에이전트 차원을 확인할 수 있습니다.

**차원**


****  

| 차원 이름 | 차원 값 | 다음 지표에 사용 가능 | 
| --- | --- | --- | 
| 연산 | [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html), [InvokeInlineAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/monitoring-agents-cw-metrics.html)  | 
| Operation, ModelId | 모든 Amazon Bedrock 코어 모델의 Operation 차원 및  modelId에 나열된 모든 Amazon Bedrock Agents 작업 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/monitoring-agents-cw-metrics.html)  | 
| Operation, AgentAliasArn, ModelId | Operation 차원에 나열된 모든 Amazon Bedrock Agents 작업 및 에이전트 별칭의 agentAliasArn으로 그룹화된 Amazon Bedrock 모델의 모든 modelId  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/monitoring-agents-cw-metrics.html)  | 

**에이전트에 CloudWatch 지표 사용**

 AWS Management Console, AWS CLI 또는 CloudWatch API를 사용하여 에이전트에 대한 지표를 가져올 수 있습니다. AWS 소프트웨어 개발 키트(SDKs) 또는 CloudWatch API 도구 중 하나를 통해 CloudWatch API를 사용할 수 있습니다.

CloudWatch에서 에이전트 지표의 네임스페이스는 `AWS/Bedrock/Agents`입니다.

CloudWatch를 사용하여 에이전트를 모니터링하려면 적절한 CloudWatch 권한이 있어야 합니다. 자세한 내용은 CloudWatch 사용 설명서의 [CloudWatch의 인증 및 액세스 제어](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)를 참조하세요.

**중요**  
CloudWatch가 CloudWatch 서비스 개선을 위해 수집된 데이터를 사용하지 않도록 하려면 옵트아웃 정책을 생성할 수 있습니다. 자세한 내용은 [AI 서비스 옵트아웃 정책](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html)을 참조하세요.

CloudWatch 대시보드에 게시된 지표가 보이지 않는 경우 에이전트를 [생성](agents-create.md)하는 데 사용한 IAM 서비스 역할에 다음 정책이 있는지 확인합니다.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Effect": "Allow",
        "Resource": "*",
        "Action": "cloudwatch:PutMetricData",
        "Condition": {
            "StringEquals": {
                "cloudwatch:namespace": "AWS/Bedrock/Agents"
            }
        }
    }
}
```

------