

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Uso Amazon CloudWatch Events na Amazon Augmented AI
<a name="a2i-cloudwatch-events"></a>

O Amazon Augmented AI usa o CloudWatch Amazon Events para alertá-lo quando o status de um ciclo de revisão humano muda `Completed` para`Failed`, `Stopped` ou. A entrega desse evento é garantida pelo menos uma vez, o que significa que todos os eventos criados quando os loops humanos terminam são entregues com sucesso à CloudWatch Events (Amazon EventBridge). Quando um ciclo de revisão muda para um desses estados, a IA Aumentada envia um evento CloudWatch para Eventos semelhante ao seguinte.

```
{
    "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"
    }
}
```

Os detalhes na saída JSON incluem o seguinte:

`creationTime`  
O time stamp de quando a Augmented AI criou o loop humano.

`failureCode`  
Um código de falha que denota um tipo específico de falha.

`failureReason`  
O motivo da falha do loop humano. O motivo da falha só é retornado quando o status do loop de revisão humana é `failed`.

`flowDefinitionArn`  
O nome de recurso da Amazon (ARN) da definição do fluxo ou do *fluxo de trabalho de revisão humana*.

`humanLoopArn`  
O nome de recurso da Amazon (ARN) do loop humano.

`humanLoopName`  
O nome do loop humano.

`humanLoopOutput`  
Um objeto que contém informações sobre a saída do loop humano.

`outputS3Uri`  
A localização do objeto do Amazon S3 onde a Augmented AI armazena a saída do loop humano.

`humanLoopStatus`  
O status do loop humano.

## Envie eventos do seu Human Loop para CloudWatch Eventos
<a name="a2i-cloud-watch-events-rule-setup"></a>

Para configurar uma regra de CloudWatch eventos para obter atualizações de status, ou *eventos*, para seus loops humanos do Amazon A2I, use o comando 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) Ao usar o comando `put-rule`, especifique o seguinte para receber status de trabalho de rotulagem: 
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`

Para configurar uma regra de CloudWatch eventos para observar todas as alterações de status, use o comando a seguir e substitua o texto do espaço reservado. Por exemplo, `"A2IHumanLoopStatusChanges"` substitua por um nome de regra de CloudWatch eventos exclusivo e *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`* pelo Amazon Resource Number (ARN) de uma função do IAM por uma política de confiança events.amazonaws.com anexada. *region*Substitua pela AWS região na qual você deseja criar a regra. 

```
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"
```

Para saber mais sobre a `put-rule` solicitação, consulte [Padrões de CloudWatch eventos em eventos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) no *Guia do usuário do Amazon CloudWatch Events*.

## Configurar um destino para processar eventos
<a name="a2i-subscribe-cloud-watch-events"></a>

Para processar eventos, você precisa configurar um destino. Por exemplo, se você quiser receber um e-mail quando o status de um loop humano mudar, use um procedimento em [Configurar notificações do Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) no *Guia CloudWatch do usuário da Amazon* para configurar um tópico do Amazon SNS e inscrever seu e-mail nele. Depois de criar um tópico, você pode usá-lo para criar um destino. 

**Para adicionar um alvo à sua regra de CloudWatch Eventos**

1. Abra o CloudWatch console: [https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home)

1. No painel de navegação, escolha **Regras**.

1. Escolha a regra à qual deseja adicionar um destino. 

1. Escolha **Ações** e, em seguida, escolha **Editar**.

1. Em **Destinos**, escolha **Adicionar destino** e escolha o AWS serviço que você deseja atuar quando um evento de alteração de status do loop humano for detectado. 

1. Configure seu destino. Para obter instruções, consulte o tópico para configurar um destino na [Documentação AWS da AWS desse serviço](https://docs.aws.amazon.com/index.html).

1. Escolha **Configure details (Configurar detalhes)**.

1. Em **Name (Nome)**, informe um nome e, opcionalmente, forneça detalhes sobre a finalidade da regra em **Description (Descrição)**. 

1. Certifique-se de que a caixa de verificação ao lado de **State (Estado)** esteja selecionada para que a regra seja listada como **Enabled (Habilitada)**. 

1. Escolha **Upgrade rule (Atualizar regra)**.

## Usar a saída da revisão humana
<a name="using-human-review-output"></a>

Depois de receber os resultados de revisão humana, você poderá analisar os resultados e compará-los com as previsões de machine learning. O JSON armazenado no bucket do Amazon S3 contém tanto as previsões de machine learning quanto os resultados da revisão humana.

## Mais informações
<a name="amazon-augmented-ai-programmatic-walkthroughs"></a>

[Eventos que a Amazon SageMaker AI envia para a Amazon EventBridge](automating-sagemaker-with-eventbridge.md)