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.
# Supervisión de Amazon Personalize con Amazon CloudWatch
Con Amazon CloudWatch, puedes obtener las métricas asociadas a Amazon Personalize. Puede configurar alarmas que le avisen cuando una o varias de estas métricas superen un umbral definido. 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/).
**Topics**
+ [Uso de CloudWatch métricas para Amazon Personalize](#using-metrics)
+ [Acceso a métricas de Amazon Personalize](#how-to-access)
+ [Crear una alarma de](#alarms)
+ [Ejemplo de aplicación de monitorización de tecnología sin servidor de Amazon Personalize](#creating-monitor-app)
+ [CloudWatch métricas de Amazon Personalize](cloudwatch-metrics.md)
## Uso de CloudWatch métricas para Amazon Personalize
Para utilizar métricas, debe especificar la siguiente información:
+ El nombre de la métrica.
+ La dimensión de la métrica. Una *dimensión* es un par de nombre-valor que le ayuda a identificar una métrica de forma inequívoca.
Puede obtener datos de supervisión de Amazon Personalize mediante la Consola de administración de AWS AWS CLI, la o la CloudWatch API. También puede utilizar la CloudWatch API a través de una AWS SDKs o de 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étrica relevante |
| --- | --- |
| ¿Cómo puedo monitorear el número de eventos que se han registrado? | Monitorice la métrica `PutEventsRequests`. |
| ¿Cómo puedo supervisar los DatasetImportJob errores? | Utilice la métrica `DatasetImportJobError`. |
| ¿Cómo puedo monitorizar la latencia de las llamadas `GetRecommendations`? | Utilice la métrica `GetRecommendationsLatency`. |
Debes tener los CloudWatch permisos adecuados para monitorizar Amazon Personalize with CloudWatch. Para obtener más información, consulta [Autenticación y control de acceso para Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## Acceso a métricas de Amazon Personalize
Los siguientes ejemplos muestran cómo acceder a las métricas de Amazon Personalize mediante la CloudWatch consola AWS CLI, la y la CloudWatch API.
**Para ver las métricas (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 **Métricas**, elija la pestaña **Todas las métricas** y, a continuación, elija `AWS/Personalize`.
1. Elija la dimensión de la métrica.
1. Elija en la lista la métrica que desea usar y elija un periodo de tiempo para el gráfico.
**Para ver las métricas de los eventos recibidos durante un periodo de tiempo (CLI)**
+ Abre AWS CLI e introduce el siguiente comando:
```
aws cloudwatch get-metric-statistics \
--metric-name PutEventsRequests \
--start-time 2019-03-15T00:00:20Z \
--period 3600 \
--end-time 2019-03-16T00:00:00Z \
--namespace AWS/Personalize \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--statistics Sum
```
Este ejemplo muestra los eventos recibidos para el ARN del rastreador de eventos durante un periodo de tiempo. Para obtener más información, consulte [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/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 de
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 métrica individual durante un periodo de tiempo que usted especifica. La alarma realiza una o varias acciones según el valor de la métrica con respecto a un umbral determinado durante varios 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 AWS 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. En el panel de navegación, elija **Alarmas** y, a continuación, elija **Crear alarma**. Esto lanza el **Asistente de creación de alarmas**.
1. Elija **Seleccionar métrica**.
1. En la pestaña **Todas las métricas**, elija `AWS/Personalize`.
1. Elige y **EventTrackerArn**, a continuación, elige **PutEventsRequests**las métricas.
1. Elija la pestaña **Métricas diagramadas**.
1. En **Estadística**, elija **Suma**.
1. Elija **Seleccionar métrica**.
1. Rellene **Nombre** y **Descripción**. En **Cuando**, elija **>** y, a continuación, escriba 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 **Siempre que 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, selecciona **Nueva lista**. CloudWatch guarda la lista y la muestra en el campo para que pueda utilizarla para configurar futuras alarmas.
**nota**
Si utiliza **Nueva lista** para crear un nuevo tema de Amazon SNS, deben verificarse 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. Elija **Crear alarma**.
**Para configurar una alarma (AWS CLI)**
+ Abra y AWS CLI, a continuación, introduzca 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 PersonalizeCLI \
--alarm-description "Alarm when more than 10 events occur" \
--metric-name PutEventsRequests \
--namespace AWS/Personalize \
--statistic Sum \
--period 300 \
--threshold 10 \
--comparison-operator GreaterThanThreshold \
--evaluation-periods 1 \
--unit Count \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--alarm-actions SNSTopicArn
```
Este ejemplo muestra cómo crear una alarma cuando se producen más de 10 eventos para el ARN del rastreador de eventos en 5 minutos. Para obtener más información, consulte [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/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/)*.
## Ejemplo de aplicación de monitorización de tecnología sin servidor de Amazon Personalize
Para ver un ejemplo de aplicación que añade funciones de supervisión, alertas y optimización para Amazon Personalize, consulte [Amazon Personalize monitor](https://github.com/aws-samples/amazon-personalize-monitor) en el repositorio de [Amazon Personalize samples](https://github.com/aws-samples/amazon-personalize-samples).
# CloudWatch métricas de Amazon Personalize
Esta sección contiene información sobre las CloudWatch métricas de Amazon disponibles para Amazon Personalize. Para obtener más información, consulte [Supervisión de Amazon Personalize con Amazon CloudWatch](personalize-monitoring.md).
En la siguiente tabla se enumeran las métricas de Amazon Personalize. Todas las métricas excepto GetRecommendations y GetPersonalizedRanking compatibles con estas estadísticas:`Average, Minimum, Maximum, Sum`. GetRecommendations y `Sum` solo GetPersonalizedRanking soporte.
| Métrica | Description (Descripción) |
| --- | --- |
| DatasetImportJobRequests | El número de llamadas correctas a la API [CreateDatasetImportJob](API_CreateDatasetImportJob.md). Dimensiones: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobError | El número de llamadas a la API `CreateDatasetImportJob` que han generado un error. Dimensiones: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobExecutionTime | El tiempo entre la llamada a la API `CreateDatasetImportJob` y la finalización (o el error) de la operación. Dimensiones: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unidad: segundos |
| DatasetSize | El tamaño de los datos importados por el trabajo de importación de conjunto de datos. Dimensiones: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unidad: bytes |
| SolutionTrainingJobRequests | El número de llamadas correctas a la API [CreateSolutionVersion](API_CreateSolutionVersion.md). Dimensiones: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobError | El número de llamadas a la API `CreateSolutionVersion` que han generado un error. Dimensiones: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobExecutionTime | El tiempo entre la llamada a la API `CreateSolutionVersion` y la finalización (o el error) de la operación. Dimensiones: `SolutionArn, SolutionVersionArn` Unidad: segundos |
| GetPersonalizedRanking | Si una llamada a la API de [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) se ha realizado correctamente. Usa la `sum` estadística para ver el recuento total de llamadas a la GetPersonalizedRanking API que se han realizado correctamente. Esta métrica no admite otras estadísticas. Dimensión: `CampaignArn` |
| GetPersonalizedRanking4xxErrors | El número de llamadas a la API `GetPersonalizedRanking` que han devuelto un código de respuesta HTTP 4xx. Dimensión: `CampaignArn` |
| GetPersonalizedRanking5xxErrors | El número de llamadas a la API `GetPersonalizedRanking` que han devuelto un código de respuesta HTTP 5xx. Dimensión: `CampaignArn` |
| GetPersonalizedRankingLatency | El tiempo transcurrido entre la recepción de la llamada a la API `GetPersonalizedRanking` y el envío de las recomendaciones (excluye los errores 4xx y 5xx). Dimensión: `CampaignArn` Unidad: milisegundos |
| GetRecommendations | Si una llamada a la API de [GetRecommendations](API_RS_GetRecommendations.md) se realiza correctamente. Usa la `sum` estadística para ver el recuento total de llamadas a la GetRecommendations API que se han realizado correctamente. Esta métrica no admite otras estadísticas. Dimensión: `CampaignArn` |
| GetRecommendations4xxErrors | El número de llamadas a la API `GetRecommendations` que han devuelto un código de respuesta HTTP 4xx. Dimensión: `CampaignArn` |
| GetRecommendations5XX errores | El número de llamadas a la API `GetRecommendations` que han devuelto un código de respuesta HTTP 5xx. Dimensión: CampaignArn |
| GetRecommendationsLatency | El tiempo transcurrido entre la recepción de la llamada a la API `GetRecommendations` y el envío de las recomendaciones (excluye los errores 4xx y 5xx). Dimensión: `CampaignArn` Unidad: milisegundos |
| PutEventsRequests | El número de llamadas correctas a la API [PutEvents](API_UBS_PutEvents.md). Dimensión: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents4xxErrors | El número de llamadas a la API `PutEvents` que han devuelto un código de respuesta HTTP 4xx. Dimensión: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents5xxErrors | El número de llamadas a la API `PutEvents` que han devuelto un código de respuesta HTTP 5xx. Dimensión: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEventLatency | El tiempo necesario para la finalización de la llamada a la API `PutEvents` (excluye los errores 4xx y 5xx). Dimensión: ` DatasetGroupArn, DatasetArn, EventTrackerArn` Unidad: milisegundos |
| PutItemsRequests | El número de llamadas correctas a la API [PutItems](API_UBS_PutItems.md). Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutItems4xxErrors | El número de llamadas a la API `PutItems` que han devuelto un código de respuesta HTTP 4xx. Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutItems5xxErrors | El número de llamadas a la API `PutItems` que han devuelto un código de respuesta HTTP 5xx. Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutItemsLatency | El tiempo necesario para la finalización de la llamada a la API `PutItems` (excluye los errores 4xx y 5xx). Dimensión: ` DatasetGroupArn, DatasetArn` Unidad: milisegundos |
| PutUsersRequests | El número de llamadas correctas a la API [PutUsers](API_UBS_PutUsers.md). Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutUsers4xxErrors | El número de llamadas a la API `PutUsers` que han devuelto un código de respuesta HTTP 4xx. Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutUsers5xxErrors | El número de llamadas a la API `PutUsers` que han devuelto un código de respuesta HTTP 5xx. Dimensión: ` DatasetGroupArn, DatasetArn` |
| PutUsersLatency | El tiempo necesario para la finalización de la llamada a la API `PutUsers` (excluye los errores 4xx y 5xx). Dimensión: ` DatasetGroupArn, DatasetArn` Unidad: milisegundos |