Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillance d'Amazon Personalize avec Amazon CloudWatch
Avec Amazon CloudWatch, vous pouvez obtenir des statistiques associées à Amazon Personalize. Vous pouvez configurer des alarmes pour vous avertir lorsqu'une ou plusieurs métriques dépassent un seuil défini. Pour consulter les statistiques, vous pouvez utiliser [Amazon CloudWatch AWS Command Line Interface](https://console.aws.amazon.com/cloudwatch/)[, Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/) ou l'[CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
**Topics**
+ [Utilisation CloudWatch des métriques pour Amazon Personalize](#using-metrics)
+ [Accès aux métriques d'Amazon Personalize](#how-to-access)
+ [Création d'une alarme](#alarms)
+ [Exemple d'application de surveillance sans serveur Amazon Personalize](#creating-monitor-app)
+ [CloudWatch statistiques pour Amazon Personalize](cloudwatch-metrics.md)
## Utilisation CloudWatch des métriques pour Amazon Personalize
Pour utiliser les métriques, vous devez spécifier les informations suivantes :
+ Nom de la métrique .
+ La dimension de métrique. Une *dimension* est une paire nom-valeur qui vous aide à identifier une métrique de façon unique.
Vous pouvez obtenir des données de surveillance pour Amazon Personalize à l' AWS Management Console aide de l'API AWS CLI, de ou de l' CloudWatch API. Vous pouvez également utiliser l' CloudWatch API par le biais de l'un des AWS SDKs ou des outils de l' CloudWatch API. La console affiche une série de graphiques basés sur les données brutes de l' CloudWatch API. En fonction de vos besoins, vous pouvez utiliser les graphiques affichés dans la console ou extraits de l’API.
La liste suivante présente certaines utilisations courantes des métriques. Voici quelques suggestions pour vous aider à démarrer, qui ne forment pas une liste exhaustive.
| Comment... ? | Métrique pertinente |
| --- | --- |
| Comment puis-je suivre le nombre d'événements qui ont été enregistrés ? | Surveiller la métrique `PutEventsRequests`. |
| Comment puis-je surveiller les DatasetImportJob erreurs ? | Utilisez la métrique `DatasetImportJobError`. |
| Comment puis-je surveiller la latence des appels `GetRecommendations` ? | Utilisez la métrique `GetRecommendationsLatency`. |
Vous devez disposer des CloudWatch autorisations appropriées pour surveiller Amazon Personalize avec CloudWatch. Pour plus d'informations, consultez [Authentification et contrôle d'accès pour Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## Accès aux métriques d'Amazon Personalize
Les exemples suivants montrent comment accéder aux métriques Amazon Personalize à l'aide de la CloudWatch console AWS CLI, de l'API et de l' CloudWatch API.
**Pour consulter les métriques (console)**
1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Choisissez **Métriques**, cliquez sur l'onglet **Toutes les mesures**, puis sélectionnez`AWS/Personalize`.
1. Choisissez la dimension de métrique.
1. Choisissez la métrique souhaitée dans la liste, puis une période pour le graphique.
**Pour afficher les métriques pour les événements reçus sur une période de temps (CLI)**
+ Ouvrez le AWS CLI et entrez la commande suivante :
```
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
```
Cet exemple illustre les événements reçus pour l'ARN de dispositif de suivi d’événements donné sur une période de temps. Pour de plus amples informations, veuillez consulter [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).
**Pour accéder aux métriques (CloudWatch API)**
+ Appelez `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Pour plus d'informations, consultez le [Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## Création d'une alarme
Vous pouvez créer une CloudWatch alarme qui envoie un message Amazon Simple Notification Service (Amazon SNS) lorsque l'état de l'alarme change. Une alarme surveille une métrique sur la période que vous spécifiez. Elle réalise une ou plusieurs actions en fonction de la valeur de la métrique par rapport à un seuil donné sur un certain nombre de périodes. L'action est une notification envoyée à une rubrique ou à une AWS Auto Scaling politique Amazon SNS.
Les alarmes déclenchent des actions uniquement pour les changements d'état prolongés. CloudWatch les alarmes n'appellent pas d'actions simplement parce qu'elles sont dans un état particulier. L’état doit avoir changé et avoir été maintenu pendant un nombre de périodes spécifié.
**Pour définir une alarme (console)**
1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le volet de navigation, choisissez **Alarmes**, puis **Créer une alarme**. L’assistant **Create Alarm** démarre.
1. Choisissez **Select metric** (Sélectionner une métrique).
1. Dans l'onglet **Toutes les mesures**, choisissez`AWS/Personalize`.
1. Choisissez **EventTrackerArn**, puis sélectionnez **PutEventsRequests**les métriques.
1. Sélectionnez l'onglet **Graphed metrics (Graphiques des métriques)**.
1. Pour **Statistic (Statistique)**, choisissez **Sum (Somme)**.
1. Choisissez **Select metric** (Sélectionner une métrique).
1. Remplissez les champs **Nom** et **Description**. Pour **Lorsque**, choisissez **>**, puis entrez une valeur maximale de votre choix.
1. Si vous souhaitez vous CloudWatch envoyer un e-mail lorsque l'état d'alarme est atteint, pour **Whenever this alarm :**, choisissez **State is ALARM**. Afin d’envoyer des alarmes à une rubrique Amazon SNS existante, pour **Envoyer une notification à :** choisissez une rubrique SNS existante. Pour définir le nom et les adresses e-mail d'une nouvelle liste d'abonnement par e-mail, choisissez **Nouvelle liste**. CloudWatch enregistre la liste et l'affiche sur le terrain afin que vous puissiez l'utiliser pour définir de futures alarmes.
**Note**
Si vous utilisez **Nouvelle liste** pour créer une nouvelle rubrique Amazon SNS, les adresses e-mail doivent être vérifiées avant que les destinataires ne reçoivent des notifications. Amazon SNS n’envoie les e-mails que lorsque l’alarme passe à l’état d’alarme. Si ce changement d’état de l’alarme se produit avant la vérification des adresses de messagerie, les destinataires prévus ne reçoivent pas de notification.
1. Sélectionnez **Créer une alerte**.
**Pour définir une alarme (AWS CLI)**
+ Ouvrez le AWS CLI, puis entrez la commande suivante. Modifiez la valeur du `alarm-actions` paramètre pour faire référence à une rubrique Amazon SNS que vous avez créée précédemment.
```
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
```
Cet exemple montre comment créer une alarme lorsque plus de 10 événements se produisent pour l'ARN de dispositif de suivi d’événement donné dans un délai de 5 minutes. Pour de plus amples informations, veuillez consulter [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html).
**Pour configurer une alarme (CloudWatch API)**
+ Appelez `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Pour plus d'informations, consultez *[Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.
## Exemple d'application de surveillance sans serveur Amazon Personalize
Pour un exemple d'application qui ajoute des fonctionnalités de surveillance, d'alerte et d'optimisation pour Amazon Personalize, consultez [Amazon Personalize monitor](https://github.com/aws-samples/amazon-personalize-monitor) dans le référentiel d'[échantillons Amazon Personalize](https://github.com/aws-samples/amazon-personalize-samples).
# CloudWatch statistiques pour Amazon Personalize
Cette section contient des informations sur les CloudWatch métriques Amazon disponibles pour Amazon Personalize. Pour de plus amples informations, veuillez consulter [Surveillance d'Amazon Personalize avec Amazon CloudWatch](personalize-monitoring.md).
Le tableau suivant répertorie les métriques Amazon Personalize. Toutes les mesures sauf GetRecommendations et GetPersonalizedRanking soutiennent ces statistiques :`Average, Minimum, Maximum, Sum`. GetRecommendations et GetPersonalizedRanking support `Sum` uniquement.
| Métrique | Description |
| --- | --- |
| DatasetImportJobRequests | Le nombre d'appels d'API [CreateDatasetImportJob](API_CreateDatasetImportJob.md) réussis. Dimensions : `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobError | Le nombre d'appels d'API `CreateDatasetImportJob` ayant entraîné une erreur. Dimensions : `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobExecutionTime | Le temps entre l'appel d'API `CreateDatasetImportJob` et l'achèvement (ou l'échec) de l'opération. Dimensions : `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unité : secondes |
| DatasetSize | La taille des données importées par la tâche d'importation d’ensembles de données. Dimensions : `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unité : octets |
| SolutionTrainingJobRequests | Le nombre d'appels d'API [CreateSolutionVersion](API_CreateSolutionVersion.md) réussis. Dimensions : `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobError | Le nombre d'appels d'API `CreateSolutionVersion` ayant entraîné une erreur. Dimensions : `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobExecutionTime | Le temps entre l'appel d'API `CreateSolutionVersion` et l'achèvement (ou l'échec) de l'opération. Dimensions : `SolutionArn, SolutionVersionArn` Unité : secondes |
| GetPersonalizedRanking | Si un appel [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) d'API est réussi. Utilisez les `sum` statistiques pour afficher le nombre total d'appels d' GetPersonalizedRanking API réussis. Cette métrique ne prend pas en charge les autres statistiques. Dimension : `CampaignArn` |
| GetPersonalizedRanking4xxErrors | Le nombre d'appels d'API `GetPersonalizedRanking` ayant retourné un code de réponse HTTP 4xx. Dimension : `CampaignArn` |
| GetPersonalizedRanking5xxErrors | Le nombre d'appels d'API `GetPersonalizedRanking` ayant retourné un code de réponse HTTP 5xx. Dimension : `CampaignArn` |
| GetPersonalizedRankingLatency | La durée entre la réception de l'appel `GetPersonalizedRanking` d'API et l'envoi des recommandations (à l’exception des erreurs 4xx et 5xx). Dimension : `CampaignArn` Unité : millisecondes |
| GetRecommendations | Si un appel [GetRecommendations](API_RS_GetRecommendations.md) d'API est réussi. Utilisez les `sum` statistiques pour afficher le nombre total d'appels d' GetRecommendations API réussis. Cette métrique ne prend pas en charge les autres statistiques. Dimension : `CampaignArn` |
| GetRecommendations4xxErrors | Le nombre d'appels d'API `GetRecommendations` ayant retourné un code de réponse HTTP 4xx. Dimension : `CampaignArn` |
| GetRecommendationsErreurs 5xx | Le nombre d'appels d'API `GetRecommendations` ayant retourné un code de réponse HTTP 5xx. Dimension : CampaignArn |
| GetRecommendationsLatency | La durée entre la réception de l'appel `GetRecommendations` d'API et l'envoi des recommandations (à l’exception des erreurs 4xx et 5xx). Dimension : `CampaignArn` Unité : millisecondes |
| PutEventsRequests | Le nombre d'appels d'API [PutEvents](API_UBS_PutEvents.md) réussis. Dimension :` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents4xxErrors | Le nombre d'appels d'API `PutEvents` ayant retourné un code de réponse HTTP 4xx. Dimension : ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents5xxErrors | Le nombre d'appels d'API `PutEvents` ayant retourné un code de réponse HTTP 5xx. Dimension : ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEventLatency | La durée nécessaire pour l'achèvement de l'appel `PutEvents` d'API (à l’exception des erreurs 4xx et 5xx). Dimension : ` DatasetGroupArn, DatasetArn, EventTrackerArn` Unité : millisecondes |
| PutItemsRequests | Le nombre d'appels d'API [PutItems](API_UBS_PutItems.md) réussis. Dimension :` DatasetGroupArn, DatasetArn` |
| PutItems4xxErrors | Le nombre d'appels d'API `PutItems` ayant retourné un code de réponse HTTP 4xx. Dimension : ` DatasetGroupArn, DatasetArn` |
| PutItems5xxErrors | Le nombre d'appels d'API `PutItems` ayant retourné un code de réponse HTTP 5xx. Dimension : ` DatasetGroupArn, DatasetArn` |
| PutItemsLatency | La durée nécessaire pour l'achèvement de l'appel `PutItems` d'API (à l’exception des erreurs 4xx et 5xx). Dimension : ` DatasetGroupArn, DatasetArn` Unité : millisecondes |
| PutUsersRequests | Le nombre d'appels d'API [PutUsers](API_UBS_PutUsers.md) réussis. Dimension :` DatasetGroupArn, DatasetArn` |
| PutUsers4xxErrors | Le nombre d'appels d'API `PutUsers` ayant retourné un code de réponse HTTP 4xx. Dimension : ` DatasetGroupArn, DatasetArn` |
| PutUsers5xxErrors | Le nombre d'appels d'API `PutUsers` ayant retourné un code de réponse HTTP 5xx. Dimension : ` DatasetGroupArn, DatasetArn` |
| PutUsersLatency | La durée nécessaire pour l'achèvement de l'appel `PutUsers` d'API (à l’exception des erreurs 4xx et 5xx). Dimension : ` DatasetGroupArn, DatasetArn` Unité : millisecondes |