Monitorando o reconhecimento com o Amazon CloudWatch

Com o 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 da sua solução baseada no Rekognition e configurar alarmes para notificá-lo quando uma ou mais métricas estão 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 o Amazon CloudWatch, o Amazon AWS Command Line Interface, ou a API CloudWatch.

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).

Usando métricas do CloudWatch para o 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 para o Rekognition usando a API AWS Management Console, a ou a API AWS CLICloudWatch. Você também pode usar a API do CloudWatch por meio de um dos kits de desenvolvimento de software (SDKs) da Amazon AWS ou das ferramentas de API do CloudWatch. O console exibe uma série de gráficos com base nos dados brutos da API do CloudWatch. 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 permissões apropriadas do CloudWatch para monitorar o Rekognition com o CloudWatch. Para obter mais informações, consulte Autenticação e controle de acesso para o Amazon CloudWatch.

Métricas de reconhecimento de acesso

Os exemplos a seguir mostram como acessar as métricas do Rekognition usando o console do CloudWatch, o e a API AWS CLI CloudWatch.

Para visualizar métricas (console)

1. Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Métricas, escolha a guia Todas as métricas e, em seguida, escolha Rekognition.

3. Escolha Métricas sem dimensões e, em seguida, escolha uma métrica.

   Por exemplo, escolha a métrica DetectedFace para medir quantas faces foram detectadas.

4. 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 a AWS CLI e digite o comando a seguir:

  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.

Para acessar métricas (API CloudWatch)

• Chame GetMetricStatistics. Para obter mais informações, consulte a Referência da API Amazon CloudWatch.

Criar um alarme

Você pode criar um alarme do CloudWatch 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 alertas invocam ações apenas para alterações de estado mantidas. Os alarmes do CloudWatch não invocam ações só porque estão em um determinado estado. O estado deve ter sido alterado e mantido por um período especificado.

Para definir um alarme (console)

1. Faça login no AWS Management Console e abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Create Alarm. Isso executa o Create Alarm Wizard.

3. Na lista de métricas Metrics with no dimensions, escolha Rekognition Metrics e escolha uma métrica.

   Por exemplo, escolha DetectedFaceCount para definir um alarme para um número máximo de faces detectadas.

4. 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 Next (Avançar).

5. Preencha o Name e a Description. Em Whenever, escolha >= e digite um valor máximo de sua escolha.

6. Se quiser que o CloudWatch lhe envie um e-mail quando o estado do alarme for atingido, para Sempre que este alarme:, escolha Estado como 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, o CloudWatch salva a lista e a exibe 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.

7. Visualize o alarme na seção Alarm Preview. Escolha Create Alarm.

Para definir um alarme (AWS CLI)

• Abra a AWS CLI e digite o comando a seguir. 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.

Para definir um alarme (API CloudWatch)

• Chame PutMetricAlarm. Para obter mais informações, consulte Referência da API Amazon CloudWatch.

Métricas do CloudWatch para Rekognition

Esta seção contém informações sobre as métricas do Amazon CloudWatch e a dimensão de operação disponível 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).

Métricas do CloudWatch para Rekognition

A tabela a seguir resume as métricas do Rekognition.

Métrica	Descrição
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ística válida: 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. Unidade: contagem Estatística válida: Sum,Average
ResponseTime	O tempo em milissegundos para o Rekognition computar a resposta. Unidades: Contagem de estatísticas Data Samples Milissegundos para estatísticas Average Estatística válida: Data Samples,Average nota 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ística válida: Sum,Average
DetectedLabelCount	O número de rótulos detectados com a operação DetectLabels. Unidade: contagem Estatística válida: 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ística válida: 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ística válida: Sum,Average
Unidades mínimas de inferência	O número mínimo de unidades de inferência especificadas durante a solicitação StartProjectVersion. Unidade: contagem Estatística válida: Average
Unidades máximas de inferência	O número máximo de unidades de inferência especificadas durante a solicitação StartProjectVersion . Unidade: contagem Estatística válida: Average
Unidades de inferência desejadas	O número de unidades de inferência para as quais o Rekognition está aumentando ou diminuindo. Unidade: contagem Estatística válida: Average
Em unidades de inferência de serviço	O número de unidades de inferência que o modelo está usando. Unidade: contagem Estatística válida: Average É recomendável usar a estatística Média para obter a média de 1 minuto de quantas instâncias são usadas.

Métricas do CloudWatch 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	Descrição
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ística válida: Sum,Average
CallCount	O número de operações especificadas executadas em sua conta. Estatística válida: 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. Unidade: contagem Estatística válida: 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ística válida: 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ística válida: Sum,Average

Dimensão do CloudWatch 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 no Guia do usuário do Amazon CloudWatch.

Dimensão do CloudWatch para rótulos personalizados do Rekognition

A tabela a seguir mostra as dimensões do CloudWatch disponíveis para uso com os rótulos personalizados do Rekognition:

Dimensão	Descrição
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 no Guia do usuário do Amazon CloudWatch.