Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# 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](https://console.aws.amazon.com/cloudwatch/) AWS Command Line Interface, [Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/) o la [CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
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)](aggregated-metrics.md).
## 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 Consola de administración de AWS 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## 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)**
1. Abra la consola en CloudWatch . [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch)
1. Elija **Métricas**, elija la pestaña **Todas las métricas** y, a continuación, elija **Rekognition**.
1. 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.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html).
**Para acceder a las métricas (CloudWatch API)**
+ Llamar a `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Para obtener más información, consulta la [referencia de la CloudWatch API de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## 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)**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Elija **Crear alarma**. Esto lanza el **Asistente de creación de alarmas**.
1. 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.
1. 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**.
1. Rellene **Nombre** y **Descripción**. Para **Siempre que**, elija **>=** e introduzca un valor máximo de su elección.
1. 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.
1. 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)**
+ 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](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html).
**Para configurar una alarma (CloudWatch API)**
+ Llamar a `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Para obtener más información, consulta *[Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.
## CloudWatch mé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)](aggregated-metrics.md).
### CloudWatch métricas de Rekognition
En la siguiente tabla se indican las métricas de Rekognition.
| Métrica | Description (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](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Unidad: recuento Estadísticas válidas: `Sum,Average` |
| ResponseTime | El tiempo en milisegundos que tarda Rekognition en calcular la respuesta. Unidades: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/rekognition/latest/dg/rekognition-monitoring.html) Estadísticas válidas: `Data Samples,Average` 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: recuentoEstadísticas válidas: `Average` |
| MaxInferenceUnits | El número máximo de unidades de inferencia especificadas durante la solicitud de StartProjectVersion .Unidad: recuentoEstadí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 | Description (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](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). 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 | La cantidad de sesiones simultáneas que esta cuenta utiliza actualmente.Unidad: recuentoEstadí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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) 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 | Description (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 sobre las dimensiones, consulta [Dimensiones](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) en la *Guía del CloudWatch usuario de Amazon*.