Monitorización de Rekognition con Amazon CloudWatch

Con CloudWatch, puede obtener métricas de las distintas operaciones de Rekognition o métricas globales de Rekognition para su cuenta. Puede usar las métricas para realizar un seguimiento del estado de la solución basada en Rekognition y configurar alarmas para que se le notifique cuando una o varias métricas queden fuera del 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, puede utilizar Amazon CloudWatch, Amazon AWS Command Line Interface o la API de CloudWatch.

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 métricas de CloudWatch 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 de Rekognition usando la AWS Management Console, la AWS CLI o la API de CloudWatch. También puede utilizar la API de CloudWatch mediante uno de los kits de desarrollo de software (SDK) de Amazon AWS o las herramientas de la API de Amazon CloudWatch. La consola muestra una serie de gráficos basados en los datos sin procesar de la API de CloudWatch. 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 disponer de los permisos de CloudWatch adecuados para monitorizar 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 tener acceso a métricas de Rekognition mediante la consola de CloudWatch, la AWS CLI y la API de CloudWatch.

Para ver las métricas (consola)

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. Elija Métricas, elija la pestaña Todas las métricas y, a continuación, elija Rekognition.

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

4. 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 la AWS CLI y escriba 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 (API de CloudWatch)

• Llame a GetMetricStatistics. Para obtener más información, consulte la referencia de la API de Amazon CloudWatch.

Crear una alarma

Puede crear una alarma de CloudWatch 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 periodo 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 periodos 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 para los cambios de estado prolongados. Las alarmas de CloudWatch no invocan acciones simplemente porque se encuentren 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)

1. Inicie sesión en la AWS Management Console y abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. Elija Crear alarma. Esto lanza el Asistente de creación de alarmas.

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

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

5. Rellene Nombre y Descripción. Para Siempre que, elija >= e introduzca un valor máximo de su elección.

6. Si desea que CloudWatch le envíe un correo electrónico cuando se alcance el estado de la alarma, para Siempre que esta alarma, elija El estado es ALARMA. Para enviar alarmas a un tema de Amazon SNS existente, en Enviar notificación a:, elija un tema de SNS existente. Para definir el nombre y las direcciones de correo electrónico para una nueva lista de suscripción de correo electrónico, elija Crear tema, CloudWatch guarda la lista y la muestra en el campo para que pueda utilizarla para definir nuevas 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.

7. Obtenga una vista previa de la alarma en la sección Vista previa de la alarma. Elija Crear alarma.

Para configurar una alarma (AWS CLI)

• Abra la AWS CLI y escriba el siguiente comando. 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 establecer una alarma (API de CloudWatch)

• Llame a PutMetricAlarm. Para obtener más información, consulte la Referencia de la API de Amazon CloudWatch.

Métricas de CloudWatch para Rekognition

Esta sección contiene información acerca de las métricas de Amazon CloudWatch y la dimensión Operation disponibles 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).

Métricas de CloudWatch para 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.

Métricas de CloudWatch 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

Dimensión de CloudWatch 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 acerca de las dimensiones, consulte Dimensiones en la Guía de usuarios de Amazon CloudWatch.

Dimensión de CloudWatch para Etiquetas personalizadas de Rekognition

En la siguiente tabla se muestran las dimensiones de CloudWatch disponibles para su uso con Etiquetas personalizadas de 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.

Para obtener más información acerca de las dimensiones, consulte Dimensiones en la Guía de usuarios de Amazon CloudWatch.