Uso de CloudWatch métricas para Rekognition Acceso a métricas de Rekognition Crear una alarma CloudWatchmétricas de Rekognition

Monitorización de Rekognition con Amazon CloudWatch

Con ella CloudWatch, puede obtener métricas para operaciones individuales de Rekognition o métricas globales de Rekognition para su cuenta. Puede usar métricas para realizar un seguimiento del estado de su solución basada en Rekognition y configurar alarmas que le notifiquen cuando una o más métricas superen un umbral definido. Por ejemplo, puede ver métricas del número de errores de servidor que se han producido o métricas del número de rostros que se han detectado. También puede consultar métricas del número de veces que se ha realizado correctamente una operación de Rekognition específica. Para ver las métricas, puedes usar Amazon CloudWatch AWS Command Line Interface, Amazon o la CloudWatch API.

También puede ver métricas globales durante un periodo de tiempo seleccionado mediante la consola de Rekognition. Para obtener más información, consulte Ejercicio 4: Consultar métricas totales (consola).

Uso de CloudWatch métricas para Rekognition

Para utilizar métricas, debe especificar la siguiente información:

La dimensión de las métricas o ninguna dimensión. Una dimensión es un par de nombre-valor que le ayuda a identificar una métrica de forma inequívoca. Rekognition tiene una dimensión denominada Operation. Proporciona métricas para una operación específica. Si no especifica ninguna dimensión, el ámbito de la métrica se establece en todas las operaciones de Rekognition dentro de su cuenta.
El nombre de la métrica, como UserErrorCount.

Puede obtener datos de monitorización para Rekognition mediante la, AWS CLI la o AWS Management Console la API. CloudWatch También puede usar la CloudWatch API a través de uno de los kits de desarrollo de software de Amazon AWS (SDKs) o las herramientas de la CloudWatch API. La consola muestra una serie de gráficos basados en los datos sin procesar de la CloudWatch API. En función de sus necesidades, es posible que prefiera utilizar los gráficos que se muestran en la consola o que se recuperan de la API.

En la siguiente lista se indican algunos usos frecuentes de las métricas. Se trata de sugerencias que puede usar como punto de partida y no de una lista completa.

¿Cómo?	Métricas relevantes
¿Cómo realizo un seguimiento del número de rostros reconocidos?	Monitorice la estadística `Sum` de la métrica `DetectedFaceCount`.
¿Cómo puedo saber si mi aplicación ha alcanzado el número máximo de solicitudes por segundo?	Monitorice la estadística `Sum` de la métrica `ThrottledCount`.
¿Cómo puedo monitorizar los errores de solicitud?	Utilice la estadística `Sum` de la métrica `UserErrorCount`.
¿Cómo puedo encontrar el número total de solicitudes?	Utilice las estadísticas `ResponseTime` y `Data Samples` de la métrica `ResponseTime`. Esto incluye cualquier solicitud que genere un error. Si desea ver únicamente las llamadas a operaciones que se han realizado con éxito, use la métrica `SuccessfulRequestCount`.
¿Cómo puedo monitorizar la latencia de las llamadas a operaciones de `Rekognition`?	Utilice la métrica `ResponseTime`.
¿Cómo puedo monitorizar cuántas veces `IndexFaces` añade correctamente rostros a las colecciones de Rekognition?	Monitorice la estadística `Sum` con la métrica `SuccessfulRequestCount` y la operación `IndexFaces`. Utilice la dimensión `Operation` para seleccionar la operación y la métrica.

Debe tener los CloudWatch permisos adecuados para monitorear Rekognition con. CloudWatch Para obtener más información, consulte Autenticación y control de acceso de Amazon CloudWatch.

Acceso a métricas de Rekognition

Los siguientes ejemplos muestran cómo acceder a las métricas de Rekognition mediante la consola, AWS CLI la y CloudWatch la API. CloudWatch

Para ver las métricas (consola)

Abra la consola en CloudWatch . https://console.aws.amazon.com/cloudwatch/
Elija Métricas, elija la pestaña Todas las métricas y, a continuación, elija Rekognition.
Elija Métricas sin dimensiones y, a continuación, elija una métrica.

Por ejemplo, elija la métrica DetectedFace para medir la cantidad de rostros que se han detectado.
Elija un valor para el intervalo de fechas. El número de métricas se muestra en el gráfico.

Para ver las métricas de las llamadas a la operación `DetectFaces` que se han realizado correctamente durante un periodo de tiempo (CLI).

Abra AWS CLI e introduzca el siguiente 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 ejemplo muestra las llamadas a la operación DetectFaces que se han realizado correctamente durante un periodo de tiempo. Para obtener más información, consulte get-metric-statistics.

Para acceder a las métricas (CloudWatch API)

Llamar a GetMetricStatistics. Para obtener más información, consulta la referencia de la CloudWatch API de Amazon.

Crear una alarma

Puede crear una CloudWatch alarma que envíe un mensaje de Amazon Simple Notification Service (Amazon SNS) cuando la alarma cambie de estado. Una alarma vigila una única métrica durante el período especificado y realiza una o varias acciones en función del valor de la métrica relativo a un determinado umbral durante una serie de períodos de tiempo. La acción es una notificación que se envía a un tema de Amazon SNS o a una política de Auto Scaling.

Las alarmas invocan acciones únicamente en caso de cambios de estado sostenidos. CloudWatch las alarmas no invocan acciones simplemente porque se encuentran en un estado determinado. El estado debe haber cambiado y debe mantenerse durante el número de periodos de tiempo especificado.

Para configurar una alarma (consola)

Inicie sesión en AWS Management Console y abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/.
Elija Crear alarma. Esto lanza el Asistente de creación de alarmas.
En la lista Métricas sin dimensiones, elija Métricas de Rekognition y, a continuación, elija una métrica.

Por ejemplo, elija DetectedFaceCount para configurar una alarma para un número máximo de rostros detectados.
En el área Intervalo de tiempo, seleccione un valor de intervalo de fechas que incluya las operaciones de detección de rostros a las que ha llamado. Elija Siguiente.
Rellene Nombre y Descripción. Para Siempre que, elija >= e introduzca un valor máximo de su elección.
Si CloudWatch quieres enviarte un correo electrónico cuando se alcance el estado de alarma, en Cuando esta alarma:, selecciona State is ALARM. Para enviar alarmas a un tema de Amazon SNS existente, en Enviar notificación a:, elija un tema de SNS existente. Para configurar el nombre y las direcciones de correo electrónico de una nueva lista de suscripciones de correo electrónico, elija Crear tema para CloudWatch guardar la lista y mostrarla en el campo para que pueda usarla para configurar futuras alarmas.

nota
Si utiliza Crear tema para crear un nuevo tema de Amazon SNS, debe verificar las direcciones de correo electrónico para que los destinatarios previstos puedan recibir las notificaciones. Amazon SNS envía solo mensajes de correo electrónico cuando la alarma entra en un estado de alarma. Si este cambio en el estado de la alarma se produce antes de que se verifiquen las direcciones de correo electrónico, los destinatarios no reciben una notificación.
Obtenga una vista previa de la alarma en la sección Vista previa de la alarma. Seleccione Crear alarma.

Para configurar una alarma (AWS CLI)

Abre el comando siguiente AWS CLI e introdúcelo. Cambie el valor del parámetro alarm-actions de forma que haga referencia a un tema de Amazon SNS que haya creado 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 ejemplo muestra cómo crear una alarma para cuando se producen más de 10 errores de usuario en 5 minutos. Para obtener más información, consulte put-metric-alarm.

Para configurar una alarma (CloudWatch API)

Llamar a PutMetricAlarm. Para obtener más información, consulta Amazon CloudWatch API Reference.

CloudWatchmétricas de Rekognition

Esta sección contiene información sobre las CloudWatch métricas de Amazon y la dimensión de operación disponible para Amazon Rekognition.

También puede ver una vista completa de métricas de Rekognition desde la consola de Rekognition. Para obtener más información, consulte Ejercicio 4: Consultar métricas totales (consola).

CloudWatch métricas de Rekognition

En la siguiente tabla se indican las métricas de Rekognition.

Métrica	Descripción
SuccessfulRequestCount	El número de solicitudes realizadas correctamente. El intervalo de códigos de respuesta para una solicitud realizada correctamente comprende de 200 a 299. Unidad: recuento Estadísticas válidas: `Sum,Average`
ThrottledCount	El número de solicitudes restringidas. Rekognition restringe una solicitud cuando recibe más solicitudes que el límite de transacciones por segundo de su cuenta. Si el límite establecido para su cuenta se supera con frecuencia, puede solicitar un aumento del límite. Para solicitar un aumento, consulte Límites de los servicios de AWS. Unidad: recuento Estadísticas válidas: `Sum,Average`
ResponseTime	El tiempo en milisegundos que tarda Rekognition en calcular la respuesta. Unidades: Recuento para la estadística `Data Samples` Milisegundos para la estadística `Average` Estadísticas válidas: `Data Samples,Average` nota La métrica `ResponseTime` no está incluida en el panel de métricas de Rekognition.
DetectedFaceCount	El número de rostros detectados con la operación `IndexFaces` o `DetectFaces`. Unidad: recuento Estadísticas válidas: `Sum,Average`
DetectedLabelCount	El número de etiquetas detectadas con la operación `DetectLabels`. Unidad: recuento Estadísticas válidas: `Sum,Average`
ServerErrorCount	El número de errores de servidor. El intervalo de códigos de respuesta de un error de servidor comprende de 500 a 599. Unidad: recuento Estadísticas válidas: `Sum, Average`
UserErrorCount	El número de errores de usuario (parámetros no válidos, imagen no válida, sin permiso, etc.). El intervalo de códigos de respuesta de un error de usuario comprende de 400 a 499. Unidad: recuento Estadísticas válidas: `Sum,Average`
MinInferenceUnits	El número mínimo de unidades de inferencia especificadas durante la solicitud de `StartProjectVersion`. Unidad: recuento Estadísticas válidas: `Average`
MaxInferenceUnits	El número máximo de unidades de inferencia especificadas durante la solicitud de `StartProjectVersion` . Unidad: recuento Estadísticas válidas: `Average`
DesiredInferenceUnits	El número de unidades de inferencia con las que Rekognition está haciendo la escala más grande o pequeña. Unidad: recuento Estadísticas válidas: `Average`
InServiceInferenceUnits	El número de unidades de inferencia que utiliza el modelo. Unidad: recuento Estadísticas válidas: `Average` Se recomienda utilizar la estadística Promedio para obtener el promedio de 1 minuto del número de instancias que se utilizan.

CloudWatch métricas para Rekognition Streaming

Rekognition también tiene un segundo espacio de nombres que se utiliza para las operaciones de streaming, «Rekognition Streaming». En la siguiente tabla se indican las métricas de Rekognition Streaming.

Métrica	Descripción
SuccessfulRequestCount	El número de solicitudes realizadas correctamente. El intervalo de códigos de respuesta para una solicitud realizada correctamente comprende de 200 a 299. Unidad: recuento Estadísticas válidas: `Sum,Average`
CallCount	El número de operaciones especificadas realizadas en su cuenta. Estadísticas válidas: `Sum,Average`
ThrottledCount	El número de solicitudes restringidas. Rekognition restringe una solicitud cuando recibe más solicitudes que el límite de transacciones por segundo de su cuenta. Si el límite establecido para su cuenta se supera con frecuencia, puede solicitar un aumento del límite. Para solicitar un aumento, consulte Límites de los servicios de AWS. Unidad: recuento Estadísticas válidas: `Sum,Average`
ServerErrorCount	El número de errores de servidor. El intervalo de códigos de respuesta de un error de servidor comprende de 500 a 599. Unidad: recuento Estadísticas válidas: `Sum, Average`
UserErrorCount	El número de errores de usuario (parámetros no válidos, imagen no válida, sin permiso, etc.). El intervalo de códigos de respuesta de un error de usuario comprende de 400 a 499. Unidad: recuento Estadísticas válidas: `Sum,Average`
ConcurrentSessions	El número de sesiones simultáneas que su cuenta utiliza actualmente. Unidad: recuento Estadísticas válidas: `Max,Average`

CloudWatch dimensión para Rekognition

Para recuperar métricas específicas de la operación, utilice el espacio de nombres Rekognition y proporcione una dimensión de operación.

Para obtener más información sobre las dimensiones, consulta Dimensiones en la Guía del CloudWatch usuario de Amazon.

CloudWatch dimensión para etiquetas personalizadas Rekognition

La siguiente tabla muestra las CloudWatch dimensiones disponibles para su uso con las etiquetas personalizadas Rekognition:

Dimensión	Descripción
ProjectName	El nombre del proyecto de Etiquetas personalizadas de Rekognition creado con `CreateProject`.
VersionName	El nombre de la versión del proyecto de Etiquetas personalizadas de Rekognition creada con `CreateProjectVersion`.