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á.
# Monitorando o Amazon Personalize com a Amazon CloudWatch
Com a Amazon CloudWatch, você pode obter métricas associadas ao Amazon Personalize. Você pode definir alarmes para notificar quando uma ou mais dessas métricas estiverem fora do limite estabelecido. Para ver as métricas, você pode usar a [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/), a Amazon ou a [CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
**Topics**
+ [Usando CloudWatch métricas para o Amazon Personalize](#using-metrics)
+ [Acessar métricas do Amazon Personalize](#how-to-access)
+ [Criar um alarme](#alarms)
+ [Exemplo de aplicativo de monitoramento de tecnologia sem servidor Amazon Personalize](#creating-monitor-app)
+ [CloudWatch métricas para Amazon Personalize](cloudwatch-metrics.md)
## Usando CloudWatch métricas para o Amazon Personalize
Para usar métricas, você deve especificar as seguintes informações:
+ O nome da métrica do .
+ A dimensão da métrica. Uma *dimensão* é um par nome/valor, que ajuda a identificar com exclusividade uma métrica.
Você pode obter dados de monitoramento para o Amazon Personalize usando a Console de gerenciamento da AWS AWS CLI, a ou a CloudWatch API. Você também pode usar a CloudWatch API por meio de uma AWS SDKs ou das ferramentas CloudWatch da API. O console exibe uma série de gráficos com base nos dados brutos da CloudWatch API. Dependendo das necessidades, você pode preferir usar os gráficos exibidos no console ou recuperados da API.
A lista a seguir mostra alguns usos comuns para as métricas. Essas são sugestões para você começar, e não uma lista abrangente.
| Como eu faço para... | Métrica relevante |
| --- | --- |
| Como faço para rastrear o número de eventos que foram registrados? | Monitorar a métrica `PutEventsRequests`. |
| Como posso monitorar os DatasetImportJob erros? | Use a métrica `DatasetImportJobError`. |
| Como posso monitorar a latência das chamadas `GetRecommendations`? | Use a métrica `GetRecommendationsLatency`. |
Você deve ter as CloudWatch permissões apropriadas para monitorar o Amazon Personalize com. CloudWatch Para obter mais informações, consulte [Autenticação e controle de acesso para a Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## Acessar métricas do Amazon Personalize
Os exemplos a seguir mostram como acessar as métricas do Amazon Personalize usando o CloudWatch console AWS CLI, o e a CloudWatch API.
**Para visualizar métricas (console)**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Métricas**, escolha a guia **Todas as métricas** e, em seguida, escolha `AWS/Personalize`.
1. Escolha a dimensão da métrica.
1. Escolha a métrica desejada na lista e um período para o gráfico.
**Para visualizar as métricas dos eventos recebidos ao longo de um período (CLI).**
+ Abra o AWS CLI e digite o seguinte comando:
```
aws cloudwatch get-metric-statistics \
--metric-name PutEventsRequests \
--start-time 2019-03-15T00:00:20Z \
--period 3600 \
--end-time 2019-03-16T00:00:00Z \
--namespace AWS/Personalize \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--statistics Sum
```
Este exemplo mostra os eventos recebidos para o ARN do rastreador de eventos fornecido ao longo de um período. Para obter mais informações, consulte [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).
**Para acessar métricas (CloudWatch API)**
+ Chame `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Para obter mais informações, consulte a [Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## Criar um alarme
Você pode criar um CloudWatch alarme que envia uma mensagem do Amazon Simple Notification Service (Amazon SNS) quando o alarme muda de estado. O alarme observa uma única métrica em um período especificado. O alarme realiza uma ou mais ações com base no valor da métrica relativa a um limite especificado durante vários períodos. A ação é uma notificação enviada a um tópico do Amazon SNS ou a uma política do AWS Auto Scaling .
Os alarmes invocam ações somente para mudanças de estado sustentadas. CloudWatch os alarmes não invocam ações simplesmente porque estão em um estado específico. O estado deve ter sido alterado e mantido por um período especificado.
**Para definir um alarme (console)**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, escolha **Alarms (Alarmes)** e escolha **Create alarm (Criar alarme)**. Isso executa o **Create Alarm Wizard**.
1. Escolha **Selecionar métrica**.
1. Na guia **Todas as métricas**, escolha `AWS/Personalize`.
1. Escolha e **EventTrackerArn**, em seguida, escolha **PutEventsRequests**métricas.
1. Escolha a guia **Graphed metrics (Métricas em gráfico)**.
1. Em **Statistic (Estatística)**, selecione **Sum (Soma)**.
1. Escolha **Selecionar métrica**.
1. Preencha o **Name** e a **Description**. Para **Whenever (Sempre)**, escolha **>** e insira o valor máximo de sua escolha.
1. Se você quiser CloudWatch enviar um e-mail quando o estado do alarme for atingido, em **Sempre que este alarme:**, escolha **Estado é ALARME**. Para enviar alarmes para um tópico existente do Amazon SNS, em **Enviar notificação para:**, escolha um tópico existente do SNS. Para definir o nome e os endereços de e-mail para uma nova lista de assinaturas de e-mail, escolha **Nova lista**. CloudWatch salva a lista e a exibe no campo para que você possa usá-la para definir futuros alarmes.
**nota**
Se você usar **Nova lista** para criar um novo tópico do Amazon SNS, os endereços de e-mail deverão ser verificados antes que os destinatários desejados recebam as notificações. O Amazon SNS envia só e-mails quando o alarme entra em um estado de alarme. Se essa alteração no estado de alarme acontecer antes dos endereços de e-mail serem verificados, os destinatários desejados não receberão uma notificação.
1. Selecione **Criar alarme**.
**Para definir um alarme (AWS CLI)**
+ Abra o e AWS CLI, em seguida, insira o seguinte comando. Altere o valor do parâmetro `alarm-actions` para fazer referência a um tópico do Amazon SNS criado anteriormente por você.
```
aws cloudwatch put-metric-alarm \
--alarm-name PersonalizeCLI \
--alarm-description "Alarm when more than 10 events occur" \
--metric-name PutEventsRequests \
--namespace AWS/Personalize \
--statistic Sum \
--period 300 \
--threshold 10 \
--comparison-operator GreaterThanThreshold \
--evaluation-periods 1 \
--unit Count \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--alarm-actions SNSTopicArn
```
Este exemplo mostra como criar um alerta para quando mais de 10 eventos ocorrem para o ARN do rastreador de eventos fornecido dentro de cinco minutos. Para obter mais informações, consulte [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html).
**Para definir um alarme (CloudWatch API)**
+ Chame `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Para obter mais informações, consulte *[Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.
## Exemplo de aplicativo de monitoramento de tecnologia sem servidor Amazon Personalize
Para um aplicativo de exemplo que adiciona recursos de monitoramento, alerta e otimização para o Amazon Personalize, consulte o [monitor do Amazon Personalize](https://github.com/aws-samples/amazon-personalize-monitor) no repositório de [amostras do Amazon Personalize](https://github.com/aws-samples/amazon-personalize-samples).
# CloudWatch métricas para Amazon Personalize
Esta seção contém informações sobre as CloudWatch métricas da Amazon disponíveis para o Amazon Personalize. Para obter mais informações, consulte [Monitorando o Amazon Personalize com a Amazon CloudWatch](personalize-monitoring.md).
A tabela a seguir lista as métricas do Amazon Personalize. Todas as métricas, exceto GetRecommendations e GetPersonalizedRanking suportam essas estatísticas:`Average, Minimum, Maximum, Sum`. GetRecommendations e `Sum` somente GetPersonalizedRanking suporte.
| Métrica | Description |
| --- | --- |
| DatasetImportJobRequests | O número de chamadas de API [CreateDatasetImportJob](API_CreateDatasetImportJob.md) bem-sucedidas. Dimensões: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobError | O número de chamadas da API `CreateDatasetImportJob` que resultaram em um erro. Dimensões: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobExecutionTime | O tempo entre a chamada de API `CreateDatasetImportJob` e a conclusão (ou falha) da operação. Dimensões: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unidade: segundos |
| DatasetSize | O tamanho dos dados importados pelo trabalho de importação do conjunto de dados. Dimensões: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unidade: bytes |
| SolutionTrainingJobRequests | O número de chamadas de API [CreateSolutionVersion](API_CreateSolutionVersion.md) bem-sucedidas. Dimensões: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobError | O número de chamadas da API `CreateSolutionVersion` que resultaram em um erro. Dimensões: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobExecutionTime | O tempo entre a chamada de API `CreateSolutionVersion` e a conclusão (ou falha) da operação. Dimensões: `SolutionArn, SolutionVersionArn` Unidade: segundos |
| GetPersonalizedRanking | Se uma chamada de API [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) foi bem-sucedida. Use a `sum` estatística para ver a contagem total de chamadas de GetPersonalizedRanking API bem-sucedidas. Essa métrica não é compatível com outras estatísticas. Dimensão: `CampaignArn` |
| GetPersonalizedRanking4xxErrors | O número de chamadas da API `GetPersonalizedRanking` que retornaram um código de resposta HTTP 4xx. Dimensão: `CampaignArn` |
| GetPersonalizedRanking5xxErrors | O número de chamadas da API `GetPersonalizedRanking` que retornaram um código de resposta HTTP 5xx. Dimensão: `CampaignArn` |
| GetPersonalizedRankingLatency | O tempo entre o recebimento da chamada da API `GetPersonalizedRanking` e o envio de recomendações (exclui os erros 4xx e 5xx). Dimensão: `CampaignArn` Unidade: milissegundos |
| GetRecommendations | Se uma chamada de API [GetRecommendations](API_RS_GetRecommendations.md) foi bem-sucedida. Use a `sum` estatística para ver a contagem total de chamadas de GetRecommendations API bem-sucedidas. Essa métrica não é compatível com outras estatísticas. Dimensão: `CampaignArn` |
| GetRecommendations4xxErrors | O número de chamadas da API `GetRecommendations` que retornaram um código de resposta HTTP 4xx. Dimensão: `CampaignArn` |
| GetRecommendationsErros 5XX | O número de chamadas da API `GetRecommendations` que retornaram um código de resposta HTTP 5xx. Dimensão: CampaignArn |
| GetRecommendationsLatency | O tempo entre o recebimento da chamada da API `GetRecommendations` e o envio de recomendações (exclui os erros 4xx e 5xx). Dimensão: `CampaignArn` Unidade: milissegundos |
| PutEventsRequests | O número de chamadas de API [PutEvents](API_UBS_PutEvents.md) bem-sucedidas. Dimensão: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents4xxErrors | O número de chamadas da API `PutEvents` que retornaram um código de resposta HTTP 4xx. Dimensão: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents5xxErrors | O número de chamadas da API `PutEvents` que retornaram um código de resposta HTTP 5xx. Dimensão: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEventLatency | O tempo necessário para a conclusão da chamada da API `PutEvents` (não inclui erros 4xx e 5xx). Dimensão: ` DatasetGroupArn, DatasetArn, EventTrackerArn` Unidade: milissegundos |
| PutItemsRequests | O número de chamadas de API [PutItems](API_UBS_PutItems.md) bem-sucedidas. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutItems4xxErrors | O número de chamadas da API `PutItems` que retornaram um código de resposta HTTP 4xx. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutItems5xxErrors | O número de chamadas da API `PutItems` que retornaram um código de resposta HTTP 5xx. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutItemsLatency | O tempo necessário para a conclusão da chamada da API `PutItems` (não inclui erros 4xx e 5xx). Dimensão: ` DatasetGroupArn, DatasetArn` Unidade: milissegundos |
| PutUsersRequests | O número de chamadas de API [PutUsers](API_UBS_PutUsers.md) bem-sucedidas. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutUsers4xxErrors | O número de chamadas da API `PutUsers` que retornaram um código de resposta HTTP 4xx. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutUsers5xxErrors | O número de chamadas da API `PutUsers` que retornaram um código de resposta HTTP 5xx. Dimensão: ` DatasetGroupArn, DatasetArn` |
| PutUsersLatency | O tempo necessário para a conclusão da chamada da API `PutUsers` (não inclui erros 4xx e 5xx). Dimensão: ` DatasetGroupArn, DatasetArn` Unidade: milissegundos |