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 Rekognition com a Amazon CloudWatch
Com CloudWatch, você pode obter métricas para operações individuais do Rekognition ou métricas globais do Rekognition para sua conta. Você pode usar métricas para monitorar a integridade de sua solução baseada no Rekognition e configurar alarmes para notificá-lo quando uma ou mais métricas estiverem fora de um limite definido. Por exemplo, você pode ver métricas para o número de erros de servidor que ocorreram ou métricas para o número de faces que foram detectadas. Você também pode ver as métricas do número de vezes que uma operação específica do Rekognition foi bem-sucedida. 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/).
Você também pode ver métricas agregadas, por um determinado período de tempo, usando o console do Rekognition. Para obter mais informações, consulte [Exercício 4: Ver métricas agregadas (console)](aggregated-metrics.md).
## Usando CloudWatch métricas para Rekognition
Para usar métricas, você deve especificar as seguintes informações:
+ A dimensão da métrica ou nenhuma dimensão. Uma *dimensão* é um par nome/valor, que ajuda a identificar com exclusividade uma métrica. O reconhecimento tem uma dimensão, denominada *Operação*. Ele fornece métricas para uma operação específica. Se você não especificar uma dimensão, a métrica terá como escopo todas as operações do Rekognition em sua conta.
+ O nome da métrica, como `UserErrorCount`.
Você pode obter dados de monitoramento do Rekognition usando Console de gerenciamento da AWS a, a ou a API. AWS CLI CloudWatch Você também pode usar a CloudWatch API por meio de um dos kits de desenvolvimento de software da Amazon AWS (SDKs) ou das ferramentas de CloudWatch 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étricas relevantes |
| --- | --- |
| Como acompanho o número de faces reconhecidas? | Monitore a estatística `Sum` da métrica `DetectedFaceCount`. |
| Como sei se meu aplicativo atingiu o número máximo de solicitações por segundo? | Monitore a estatística `Sum` da métrica `ThrottledCount`. |
| Como posso monitorar os erros de solicitação? | Use a estatística `Sum` da métrica `UserErrorCount`. |
| Como posso encontrar o número total de solicitações? | Use as estatísticas `ResponseTime` e `Data Samples` da métrica `ResponseTime`. Isso inclui qualquer solicitação que resulte em um erro. Se você quiser ver apenas as chamadas de operação bem-sucedidas, use a métrica `SuccessfulRequestCount`. |
| Como posso monitorar a latência das chamadas de operação `Rekognition`? | Use a métrica `ResponseTime`. |
| Como posso monitorar quantas vezes faces foram adicionadas à `IndexFaces` com sucesso às coleções do Rekognition? | Monitore a estatística `Sum` com a métrica `SuccessfulRequestCount` e a operação `IndexFaces`. Use a dimensão `Operation` para selecionar a operação e a métrica. |
Você deve ter as CloudWatch permissões apropriadas para monitorar o Rekognition com. CloudWatch Para obter mais informações, consulte [Autenticação e controle de acesso para o Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## Métricas de reconhecimento de acesso
Os exemplos a seguir mostram como acessar as métricas do Rekognition usando o console, o e CloudWatch a API. AWS CLI CloudWatch
**Para visualizar métricas (console)**
1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch).
1. Escolha **Metrics**, escolha a guia **All Metrics** e, em seguida, escolha **Rekognition**.
1. Escolha **Metrics with no dimensions** e, em seguida, escolha uma métrica.
Por exemplo, escolha a métrica **DetectedFace** para medir quantas faces foram detectadas.
1. Escolha um valor para o intervalo de datas. A contagem de métricas exibidas no gráfico.
**Para visualizar as métricas de chamadas bem-sucedidas da operação `DetectFaces` feitas durante um período (CLI).**
+ Abra o AWS CLI e digite o seguinte comando:
`aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2`
Este exemplo mostra as chamadas de operação `DetectFaces` bem-sucedidas feitas ao longo de um período. Para obter mais informações, consulte [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/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. Um alarme observa uma única métrica ao longo de um período especificado por você e realiza uma ou mais ações com base no valor da métrica relativo a um determinado limite ao longo de vários períodos. A ação é uma notificação enviada a um tópico do Amazon SNS ou a uma política de 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. Escolha **Criar Alarm**. Isso executa o **Create Alarm Wizard**.
1. Na lista de métricas **Metrics with no dimensions**, escolha **Rekognition Metrics** e escolha uma métrica.
Por exemplo, escolha **DetectedFaceCount** a fim de definir um alarme para um número máximo de faces detectadas.
1. Na área **Time Range**, selecione um valor de intervalo de datas que inclua as operações de detecção de faces chamadas por você. Escolha **Próximo**.
1. Preencha o **Name** e a **Description**. Em **Whenever**, escolha **>=** e digite um 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 **Criar tópico** para CloudWatch salvar a lista e exibi-la no campo para que você possa usá-la para definir futuros alarmes.
**nota**
Se você usar **Criar tópico** para criar um novo tópico do Amazon SNS, os endereços de e-mail devem ser verificados antes que os destinatários pretendidos recebam as notificações. O Amazon SNS envia e-mails somente 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. Visualize o alarme na seção **Prévia do alarme**. Escolha **Criar Alarm**.
**Para definir um alarme (AWS CLI)**
+ Abra o AWS CLI e digite o seguinte comando. Altere o valor do parâmetro `alarm-actions` para referenciar um tópico do Amazon SNS que você criou anteriormente.
`aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count`
Este exemplo mostra como criar um alerta para quando mais de 10 erros de usuário ocorrem em 5 minutos. Para obter mais informações, consulte [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/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/)*.
## CloudWatch métricas para Rekognition
Esta seção contém informações sobre as CloudWatch métricas da Amazon e a dimensão de *operação* disponíveis para o Amazon Rekognition.
Você também pode ver uma visão agregada das métricas do Rekognition no console do Rekognition. Para obter mais informações, consulte [Exercício 4: Ver métricas agregadas (console)](aggregated-metrics.md).
### CloudWatch métricas para Rekognition
A tabela a seguir resume as métricas do Rekognition.
| Métrica | Description |
| --- | --- |
| SuccessfulRequestCount | O número de solicitações bem-sucedidas. O intervalo de códigos de resposta para uma solicitação bem-sucedida vai de 200 até 299. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| ThrottledCount | O número de solicitações limitadas. O Rekognition limita uma solicitação quando recebe mais solicitações do que o limite de transações por segundo definido para sua conta. Se o limite definido para a conta for frequentemente excedido, você poderá solicitar um aumento no limite. Para solicitar um aumento, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| ResponseTime | O tempo em milissegundos para o Rekognition computar a resposta. Unidades: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/rekognition-monitoring.html) Estatísticas válidas: `Data Samples,Average` A métrica `ResponseTime` não está incluída no painel de métricas do Rekognition. |
| DetectedFaceCount | O número de faces detectadas com a operação `IndexFaces` ou `DetectFaces`. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| DetectedLabelCount | O número de rótulos detectados com a operação `DetectLabels`. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| ServerErrorCount | O número de erros do servidor. O intervalo de códigos de resposta para um erro de servidor vai de 500 até 599. Unidade: Contagem Estatísticas válidas: `Sum, Average` |
| UserErrorCount | O número de erros de usuário (parâmetros inválidos, imagem inválida, sem permissão etc). O intervalo de códigos de resposta para um erro de usuário vai de 400 até 499. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| MinInferenceUnits | O número mínimo de unidades de inferência especificadas durante a solicitação StartProjectVersion.Unidade: ContagemEstatísticas válidas: `Average` |
| MaxInferenceUnits | O número máximo de unidades de inferência especificadas durante a solicitação StartProjectVersion .Unidade: ContagemEstatísticas válidas: `Average` |
| DesiredInferenceUnits | O número de unidades de inferência para as quais o Rekognition está aumentando ou diminuindo. Unidade: Contagem Estatísticas válidas: `Average` |
| InServiceInferenceUnits | O número de unidades de inferência que o modelo está usando. Unidade: Contagem Estatísticas válidas: `Average` É recomendável usar a estatística Média para obter a média de 1 minuto de quantas instâncias são usadas. |
### CloudWatch métricas para Rekognition Streaming
O Rekognition também tem um segundo namespace usado para operações de streaming, "Rekognition Streaming". A tabela a seguir resume as métricas do Rekognition Streaming.
| Métrica | Description |
| --- | --- |
| SuccessfulRequestCount | O número de solicitações bem-sucedidas. O intervalo de códigos de resposta para uma solicitação bem-sucedida vai de 200 até 299. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| CallCount | O número de operações especificadas executadas em sua conta. Estatísticas válidas: `Sum,Average` |
| ThrottledCount | O número de solicitações limitadas. O Rekognition limita uma solicitação quando recebe mais solicitações do que o limite de transações por segundo definido para sua conta. Se o limite definido para a conta for frequentemente excedido, você poderá solicitar um aumento no limite. Para solicitar um aumento, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| ServerErrorCount | O número de erros do servidor. O intervalo de códigos de resposta para um erro de servidor vai de 500 até 599. Unidade: Contagem Estatísticas válidas: `Sum, Average` |
| UserErrorCount | O número de erros de usuário (parâmetros inválidos, imagem inválida, sem permissão etc). O intervalo de códigos de resposta para um erro de usuário vai de 400 até 499. Unidade: Contagem Estatísticas válidas: `Sum,Average` |
| ConcurrentSessions | O número de sessões simultâneas que sua conta está usando no momento.Unidade: ContagemEstatísticas válidas: `Max,Average` |
### CloudWatch dimensão para Rekognition
Para recuperar métricas específicas da operação, use o namespace `Rekognition` e forneça uma dimensão de operação.
Para obter mais informações sobre dimensões, consulte [Dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) no *Guia do CloudWatch usuário da Amazon*.
### CloudWatch dimensão para rótulos personalizados do Rekognition
A tabela a seguir mostra as CloudWatch dimensões disponíveis para uso com as etiquetas personalizadas do Rekognition:
****
| Dimensão | Description |
| --- | --- |
| ProjectName | O nome do projeto Rekognition Custom Labels que você criou com o CreateProject. |
| VersionName | O nome da versão do projeto Rekognition Custom Labels com a qual você criou CreateProjectVersion. |
Para obter mais informações sobre dimensões, consulte [Dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) no *Guia do CloudWatch usuário da Amazon*.