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

# Amazon Augmented AI Amazon CloudWatch Events 에서 사용
<a name="a2i-cloudwatch-events"></a>

Amazon Augmented AI는 인적 검토 루프 상태가 `Completed`, `Failed`, 또는 `Stopped`로 변경될 때 Amazon CloudWatch Events를 사용하여 사용자에게 경고합니다. 이 이벤트 전송은 최소 한 번 보장됩니다. 즉, 인적 루프가 종료될 때 생성되는 모든 이벤트가 CloudWatch Events(Amazon EventBridge)로 성공적으로 전송됩니다. 검토 루프가 이러한 상태 중 하나로 변경되면 Augmented AI는 다음과 유사한 이벤트를 CloudWatch Events에 전송합니다.

```
{
    "version":"0",
    "id":"12345678-1111-2222-3333-12345EXAMPLE",
    "detail-type":"SageMaker A2I HumanLoop Status Change",
    "source":"aws.sagemaker",
    "account":"1111111111111",
    "time":"2019-11-14T17:49:25Z",
    "region":"us-east-1",
    "resources":["arn:aws:sagemaker:us-east-1:111111111111:human-loop/humanloop-nov-14-1"],
    "detail":{
        "creationTime":"2019-11-14T17:37:36.740Z",
        "failureCode":null,
        "failureReason":null,
        "flowDefinitionArn":"arn:aws:sagemaker:us-east-1:111111111111:flow-definition/flowdef-nov-12",
        "humanLoopArn":"arn:aws:sagemaker:us-east-1:111111111111:human-loop/humanloop-nov-14-1",
        "humanLoopName":"humanloop-nov-14-1",
        "humanLoopOutput":{ 
            "outputS3Uri":"s3://customer-output-bucket-specified-in-flow-definition/flowdef-nov-12/2019/11/14/17/37/36/humanloop-nov-14-1/output.json"
        },
        "humanLoopStatus":"Completed"
    }
}
```

JSON 출력의 세부 정보에는 다음이 포함되어 있습니다.

`creationTime`  
Augmented AI에서 인적 루프가 생성된 타임스탬프.

`failureCode`  
특정 유형의 실패를 나타내는 실패 코드입니다.

`failureReason`  
인적 루프가 실패한 이유입니다. 실패 이유는 인적 검토 루프 상태가 `failed`일 때만 반환됩니다.

`flowDefinitionArn`  
흐름 정의 또는 인적 검토 워크플로의 Amazon 리소스 이름(ARN)입니다.**

`humanLoopArn`  
인적 루프의 Amazon 리소스 이름(ARN)입니다.

`humanLoopName`  
인적 루프의 이름입니다.

`humanLoopOutput`  
인적 루프의 출력에 대한 정보가 포함된 객체입니다.

`outputS3Uri`  
Augmented AI에서 인적 루프 출력이 저장된 Amazon S3 객체의 위치.

`humanLoopStatus`  
인적 루프의 상태입니다.

## 인적 루프의 이벤트를 CloudWatch 이벤트로 전송
<a name="a2i-cloud-watch-events-rule-setup"></a>

Amazon A2I 인적 루프에 대한 상태 업데이트 또는 *이벤트를* 가져오도록 CloudWatch Events 규칙을 구성하려면 AWS Command Line Interface (AWS CLI) [https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html) 명령을 사용합니다. `put-rule` 명령을 사용할 때 다음을 지정하여 인적 루프 상태를 수신합니다.
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`

모든 상태 변경을 감시하도록 CloudWatch Events 규칙을 구성하려면 다음 명령을 사용하여 자리 표시자 텍스트를 바꿉니다. 예를 들어, `"A2IHumanLoopStatusChanges"`를 고유한 CloudWatch Events 규칙 이름으로 바꾸고 *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`*을 events.amazonaws.com의 신뢰 정책이 연결된 IAM 역할의 Amazon 리소스 번호(ARN)로 바꿉니다. *region*을 규칙을 생성하려는 AWS 리전으로 바꿉니다.

```
aws events put-rule --name "A2IHumanLoopStatusChanges" 
    --event-pattern "{\"source\":[\"aws.sagemaker\"],\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]}" 
    --role-arn "arn:aws:iam::111122223333:role/MyRoleForThisRule" 
    --region "region"
```

`put-rule` 요청에 대한 자세한 내용은 *Amazon CloudWatch Events 사용 설명서*에서 [CloudWatch 이벤트의 이벤트 패턴](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)을 참고하세요.

## 이벤트를 처리할 대상 설정
<a name="a2i-subscribe-cloud-watch-events"></a>

이벤트를 처리하려면 대상을 설정해야 합니다. 예를 들어 인적 루프 상태가 변경될 때 이메일을 수신하려면 Amazon CloudWatch 사용 설명서의 [Amazon SNS 알림 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html)에 있는 절차를 사용하여 Amazon SNS 주제를 설정하고 해당 주제를 이메일로 구독하세요.** 주제를 생성한 후에는 사용자는 해당 주제를 사용하여 대상을 생성할 수 있습니다.

**CloudWatch Events 규칙에 대상을 추가하려면**

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

1. 탐색 창에서 **규칙**을 선택합니다.

1. 대상을 추가할 규칙을 선택합니다.

1. **작업**을 선택한 후 **편집**을 선택합니다.

1. **대상**에서 **대상 추가**를 선택하고 인적 루프 상태 변경 이벤트가 감지될 때 수행할 AWS 서비스를 선택합니다.

1. 대상을 구성합니다. 지침은 [해당 서비스에 대한AWS 설명서](https://docs.aws.amazon.com/index.html)에서 대상 구성에 대한 주제를 참고하세요.

1. **세부 정보 구성**을 선택합니다.

1. **이름**에 이름을 입력하고 선택적으로 **설명**에 규칙 용도에 대한 세부 정보를 제공합니다.

1. **상태** 옆에 있는 확인란을 선택하여 규칙이 **활성화**로 나열되도록 합니다.

1. **규칙 업데이트**를 선택합니다.

## 인적 검토 결과 사용
<a name="using-human-review-output"></a>

인적 검토 결과를 받은 후 사용자는 결과를 분석하여 기계 학습 예측과 비교할 수 있습니다. Amazon S3 버킷에 저장된 JSON에는 기계 학습 예측과 인적 검토 결과가 모두 포함되어 있습니다.

## 추가 정보
<a name="amazon-augmented-ai-programmatic-walkthroughs"></a>

[Amazon SageMaker AI에서 Amazon EventBridge로 보내는 이벤트](automating-sagemaker-with-eventbridge.md)