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 de la Rekognition avec Amazon CloudWatch
<a name="rekognition-monitoring"></a>

Vous pouvez obtenir des statistiques pour des opérations de Rekognition individuelles ou des mesures de Rekognition globales pour votre compte. Vous pouvez utiliser des métriques pour suivre l'état Rekognition-based de votre solution et configurer des alarmes pour vous avertir lorsqu'une ou plusieurs mesures dépassent un seuil défini. CloudWatch Par exemple, vous pouvez consulter les métriques pour connaître le nombre d’erreurs serveur qui se sont produites ou pour connaître le nombre de visages qui ont été détectés. Vous pouvez également consulter les métriques pour obtenir le nombre de fois où une opération Rekognition spécifique a réussi. 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/).



Vous pouvez également consulter les métriques agrégées, pour une période de temps choisie, à l’aide de la console Rekognition. Pour de plus amples informations, veuillez consulter [Exercice 4 :afficher les métriques agrégées (console)](aggregated-metrics.md).

## Utilisation de CloudWatch métriques pour la Rekognition
<a name="using-metrics"></a>

Pour utiliser les métriques, vous devez spécifier les informations suivantes :
+ La dimension de la métrique ou l’absence de dimension. Une *dimension* est une paire nom-valeur qui vous aide à identifier une métrique de façon unique. Rekognition possède une dimension nommée *Opération*. Elle fournit les métriques d’une opération spécifique. Si vous ne spécifiez pas de dimension, la portée de la métrique englobe toutes les opérations Rekognition au sein de votre compte.
+ Le nom de la métrique, par exemple `UserErrorCount`.

Vous pouvez obtenir des données de surveillance pour Rekognition à l'aide de l'API, AWS CLI de ou de AWS Management Console l'API. CloudWatch Vous pouvez également utiliser l' CloudWatch API via l'un des kits de développement logiciel (SDK) Amazon AWS ou les outils d' 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.

### 
<a name="how-do-i"></a>

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étriques pertinentes | 
| --- | --- | 
| Comment suivre le nombre de visages reconnus ? | Surveillez la statistique `Sum` de la métrique `DetectedFaceCount`. | 
| Comment savoir si mon application a atteint le nombre maximal de demandes par seconde ? | Surveillez la statistique `Sum` de la métrique `ThrottledCount`. | 
| Comment surveiller les erreurs de demande ? | Utilisez la statistique `Sum` de la métrique `UserErrorCount`. | 
| Comment obtenir le nombre total de demandes ? | Utilisez les statistiques `ResponseTime` et `Data Samples` de la métrique `ResponseTime`. Celle-ci inclut les demandes qui se sont traduites par une erreur. Si vous voulez ne voir que les appels d’opération ayant réussi, utilisez la métrique `SuccessfulRequestCount`. | 
| Comment surveiller la latences des appels de l’opération `Rekognition` ? | Utilisez la métrique `ResponseTime`. | 
| Comment surveiller le nombre de fois où `IndexFaces` a ajouté avec succès des visages aux collections Rekognition ? | Surveillez la statistique `Sum` à l’aide de la métrique `SuccessfulRequestCount` et de l’opération `IndexFaces`. Utilisez la dimension `Operation` pour sélectionner l’opération et la métrique. | 

Vous devez disposer des CloudWatch autorisations appropriées pour surveiller Rekognition avec. CloudWatch Pour de plus amples informations, veuillez consulter [Authentification et contrôle d'accès pour Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).

## Métriques Access Rekognition
<a name="how-to-access"></a>

Les exemples suivants montrent comment accéder aux métriques de Rekognition à l'aide de la console, AWS CLI de l'API et CloudWatch de l'API. CloudWatch

**Pour consulter les métriques (console)**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch).

1. Choisissez **Métriques**, puis l’onglet **Toutes les métriques**, puis **Rekognition**.

1. Choisissez **Métriques sans dimensions**, puis choisissez une métrique. 

   Par exemple, choisissez la métrique **DetectedFace** pour mesurer le nombre de visages détectés.

1. Choisissez une valeur pour la plage de dates. Nombre de métriques affichées dans le graphique. 

**Pour afficher les appels réussis de l’opération `DetectFaces` effectués sur une période de temps (CLI).**
+ Ouvrez le AWS CLI et entrez la commande suivante :

  `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` 

  Cet exemple illustre les appels réussis de l’opération `DetectFaces` effectués sur une période de temps. Pour de plus amples informations, veuillez consulter [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/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éer une alarme
<a name="alarms"></a>

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 seule métrique pendant une durée que vous définissez et exécute une ou plusieurs actions en fonction de la valeur de la métrique par rapport à un seuil donné pendant un certain nombre de périodes. L’action est une notification envoyée à une rubrique Amazon SNS ou à une stratégie Auto Scaling.

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. Sélectionnez **Create Alarm (Créer une alerte)**. L’assistant **Create Alarm** démarre. 

1. Dans la liste **Métriques sans dimensions**, choisissez **Métriques Rekognition**, puis choisissez une métrique.

   Par exemple, choisissez **DetectedFaceCount** pour définir une alarme quand le nombre maximal de visages détectés est atteint.

1. Dans la zone **Time Range**, sélectionnez une plage de dates incluant les opérations de détection de visage que vous avez appelées. Choisissez **Next** (Suivant)

1. Remplissez les champs **Nom** et **Description**. Pour **Lorsque**, choisissez **>=** et 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 **Créer un sujet** CloudWatch pour enregistrer la liste et l'afficher dans le champ afin que vous puissiez l'utiliser pour définir de futures alarmes. 
**Note**  
Si vous utilisez **Créer une rubrique** pour créer une rubrique Amazon SNS, les adresses de messagerie doivent être vérifiées avant que les destinataires prévus ne reçoivent les 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. Affichez un aperçu de l’alarme dans la section **Aperçu de l’alarme**. Sélectionnez **Create Alarm (Créer une alerte)**. 

**Pour régler une alarme (AWS CLI)**
+ Ouvrez le AWS CLI et entrez la commande suivante. Modifiez la valeur du paramètre `alarm-actions` pour faire référence à une rubrique Amazon SNS que vous avez précédemment créée. 

  `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`

  Cet exemple montre comment créer une alarme lorsque plus de 10 erreurs d’utilisateur se produisent en 5 minutes ou moins. Pour de plus amples informations, veuillez consulter [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/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/)*.

## CloudWatch métriques pour Rekognition
<a name="cloudwatch-metricsdim"></a>

Cette section contient des informations sur les CloudWatch métriques Amazon et la dimension d'*opération* disponibles pour Amazon Rekognition.

Vous pouvez aussi afficher une vue de groupe des métriques Rekognition à partir de la console Rekognition. Pour de plus amples informations, veuillez consulter [Exercice 4 :afficher les métriques agrégées (console)](aggregated-metrics.md).

### CloudWatch métriques pour Rekognition
<a name="cloudwatch-metrics"></a>

Le tableau suivant récapitule les métriques Rekognition.


| Métrique | Description | 
| --- | --- | 
| SuccessfulRequestCount | Nombre de requêtes réussies. La plage de codes de réponse d’une demande réussie est comprise entre 200 et 299. <br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| ThrottledCount | Nombre de demandes limitées. Rekognition limite une demande quand il en reçoit plus que la limite de transactions par seconde définie pour votre compte. Si cette limite est souvent franchie, vous pouvez demander une augmentation de la limite. Pour demander une augmentation, consultez [Limites de service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). <br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| ResponseTime | Durée en millisecondes pour que Rekognition calcule la réponse. <br />Unités : [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/rekognition/latest/dg/rekognition-monitoring.html)<br />Statistiques valides : `Data Samples,Average` La métrique `ResponseTime` n’est pas incluse dans le volet des métriques Rekognition.  | 
| DetectedFaceCount | Nombre de visages détectés avec l’opération `IndexFaces` ou `DetectFaces`.<br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| DetectedLabelCount | Nombre d’étiquettes détectées avec l’opération `DetectLabels`.<br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| ServerErrorCount | Nombre d’erreurs de serveur. La plage des codes de réponse d’une erreur de serveur est comprise entre 500 et 599.<br />Unité : nombre<br />Statistiques valides : `Sum, Average` | 
| UserErrorCount | Nombre d’erreurs d’utilisateur (paramètres non valides, image non valide, absence d’autorisation, etc). La plage des codes de réponse d’une erreur d’utilisateur est comprise entre 400 et 499.<br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| MinInferenceUnits | Le nombre minimum d’unités d’inférence spécifié lors de la demande StartProjectVersion.Unité : nombre<br />Statistiques valides : `Average` | 
| MaxInferenceUnits | Le nombre maximum d’unités d’inférence spécifiées lors de la demande StartProjectVersion .Unité : nombre<br />Statistiques valides : `Average` | 
| DesiredInferenceUnits | Le nombre d’unités d’inférence auxquelles Rekognition augmente ou diminue. <br />Unité : nombre<br />Statistiques valides : `Average` | 
| InServiceInferenceUnits | Nombre d’unités d’inférence utilisées par le modèle.<br />Unité : nombre<br />Statistiques valides : `Average`<br />Il est recommandé d’utiliser la statistique Average pour obtenir la moyenne sur 1 minute du nombre d’instances utilisées. | 

### CloudWatch métriques pour Rekognition Streaming
<a name="cloudwatch-streaming-metrics"></a>

Rekognition possède également un deuxième espace de noms utilisé pour les opérations de streaming, « Rekognition Streaming ». Le tableau suivant récapitule les métriques de Rekognition Streaming.


| Métrique | Description | 
| --- | --- | 
| SuccessfulRequestCount | Nombre de requêtes réussies. La plage de codes de réponse d’une demande réussie est comprise entre 200 et 299. <br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| CallCount | Nombre d’opérations spécifiées effectuées dans votre compte.<br />Statistiques valides : `Sum,Average` | 
| ThrottledCount | Nombre de demandes limitées. Rekognition limite une demande quand il en reçoit plus que la limite de transactions par seconde définie pour votre compte. Si cette limite est souvent franchie, vous pouvez demander une augmentation de la limite. Pour demander une augmentation, consultez [Limites de service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). <br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| ServerErrorCount | Nombre d’erreurs de serveur. La plage des codes de réponse d’une erreur de serveur est comprise entre 500 et 599.<br />Unité : nombre<br />Statistiques valides : `Sum, Average` | 
| UserErrorCount | Nombre d’erreurs d’utilisateur (paramètres non valides, image non valide, absence d’autorisation, etc). La plage des codes de réponse d’une erreur d’utilisateur est comprise entre 400 et 499.<br />Unité : nombre<br />Statistiques valides : `Sum,Average` | 
| ConcurrentSessions | Le nombre de sessions simultanées que votre compte utilise actuellement.Unité : nombre<br />Statistiques valides : `Max,Average` | 

### CloudWatch dimension pour Rekognition
<a name="cloudwatch-dimensions"></a>

Pour extraire les métriques spécifiques à une opération, utilisez l’espace de noms `Rekognition` et fournissez une dimension d’opération. 

Pour plus d'informations sur les dimensions, consultez la section [Dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) du *guide de CloudWatch l'utilisateur Amazon*. 

### CloudWatch dimension pour les étiquettes personnalisées Rekognition
<a name="cloudwatch-dimensions"></a>

Le tableau suivant indique les CloudWatch dimensions disponibles pour une utilisation avec les étiquettes personnalisées Rekognition :


****  

| Dimension | Description | 
| --- | --- | 
| ProjectName | Le nom du projet Rekognition Custom Labels que vous avez créé avec CreateProject. | 
| VersionName | Nom de la version du projet Rekognition Custom Labels que vous avez créée avec CreateProjectVersion. | 

Pour plus d'informations sur les dimensions, consultez la section [Dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) du *guide de CloudWatch l'utilisateur Amazon*.