En utilisant CloudWatch métriques pour Rekognition Accédez aux mesures de Rekognition Créer une alarme CloudWatchmétriques pour Rekognition

Surveillance de la Rekognition avec Amazon CloudWatch

Avec CloudWatch, vous pouvez obtenir des indicateurs pour des opérations de Rekognition individuelles ou des indicateurs de Rekognition globaux pour votre compte. Vous pouvez utiliser des indicateurs pour suivre l'état de santé de votre solution basée sur Rekognition et configurer des alarmes pour vous avertir lorsqu'un ou plusieurs indicateurs dépassent un seuil défini. 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 statistiques indiquant le nombre de fois qu'une opération de Rekognition spécifique a réussi. Pour consulter les statistiques, vous pouvez utiliserAmazon CloudWatch,AmazonAWS Command Line Interface, ou leCloudWatch API.

Vous pouvez également consulter les statistiques agrégées, pour une période donnée, à l'aide de la console Rekognition. Pour plus d'informations, veuillez consulter Exercice 4 :afficher les métriques agrégées (console).

En utilisant CloudWatch métriques pour Rekognition

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. La Rekognition a une dimension, nomméeFonctionnement. Elle fournit les métriques d'une opération spécifique. Si vous ne spécifiez aucune dimension, la métrique est étendue à toutes les opérations de Rekognition effectuées dans votre compte.
Le nom de la métrique, par exemple UserErrorCount.

Vous pouvez obtenir des données de surveillance pour Rekognition à l'aide duAWS Management Console, leAWS CLI, ou le CloudWatch API. Vous pouvez également utiliser le CloudWatch API via l'un des kits de développement logiciel (SDK) Amazon AWS ou du CloudWatch Outils d'API. La console affiche une série de graphiques basés sur les données brutes d' 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é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 puis-je contrôler combien de fois`IndexFaces`Vous avez ajouté des visages avec succès 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 du CloudWatch autorisations pour surveiller Rekognition avec CloudWatch. Pour de plus amples informations, veuillez consulter Authentification et contrôle d'accès pour Amazon CloudWatch.

Accédez aux mesures de Rekognition

Les exemples suivants montrent comment accéder aux mesures de Rekognition à l'aide du CloudWatch console, laAWS CLI, et le CloudWatchAPI.

Pour consulter les métriques (console)

Ouvrez le CloudWatch console chezhttps://console.aws.amazon.com/cloudwatch/.
Choisissez Métriques, puis l'onglet Toutes les métriques, puis Rekognition.
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.
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 l'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 plus d'informations, veuillez consulter la rubriqueget-metric-statistics.

Pour accéder aux métriques (CloudWatch API)

Appelez GetMetricStatistics. Pour de plus amples informations, veuillez consulter le .Amazon CloudWatch Référence d'API.

Créer une alarme

Vous pouvez créer une CloudWatch alarme qui envoie un message Amazon Simple Notification Service (Amazon SNS) lorsque l'alarme change d'état. 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 alertes appellent les actions pour les changements d'état soutenus uniquement. 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)

Connectez-vous auAWS Management Consoleet ouvrez le CloudWatch console chezhttps://console.aws.amazon.com/cloudwatch/.
Sélectionnez Create Alarm (Créer une alerte). L'assistant Create Alarm démarre.
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.
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)
Remplissez les champs Nom et Description. Pour Lorsque, choisissez >= et entrez une valeur maximale de votre choix.
Si tu veux CloudWatch pour vous envoyer un e-mail lorsque l'état d'alarme est atteint, pourChaque fois que cette alarme :, choisissezL'état est ALARM. Pour envoyer des alarmes à une rubrique Amazon SNS existante, pourEnvoyer une notification à :, choisissez une rubrique SNS existante. Pour définir le nom et les adresses e-mail d'une nouvelle liste d'abonnés, choisissezCréation d'une rubrique 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 utilisezCréation d'une rubriquepour 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 envoie des e-mails uniquement 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.
Affichez un aperçu de l'alarme dans la section Aperçu de l'alarme. Sélectionnez Create Alarm (Créer une alerte).

Pour définir une alarme (AWS CLI)

Ouvrez l'AWS CLI et entrez la commande suivante. Modifier la valeur dualarm-actionsparamètre pour faire référence à une rubrique Amazon SNS que vous avez 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 plus d'informations, veuillez consulter la rubriqueput-metric-alarm.

Pour régler une alarme (CloudWatch API)

Appelez PutMetricAlarm. Pour plus d'informations, veuillez consulter la rubriqueAmazon CloudWatch Référence d'API.

CloudWatchmétriques pour Rekognition

Cette section contient des informations sur Amazon CloudWatch les métriques et leFonctionnementdimension disponible pour Amazon Rekognition.

Vous pouvez également consulter une vue agrégée des métriques de Rekognition depuis la console de Rekognition. Pour plus d'informations, veuillez consulter Exercice 4 :afficher les métriques agrégées (console).

CloudWatch métriques pour Rekognition

Le tableau suivant récapitule les mesures de 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. Unité : nombre Statistiques valides : `Sum,Average`
ThrottledCount	Nombre de demandes limitées. La Rekognition limite une demande lorsqu'elle reçoit plus de demandes que la limite de transactions par seconde fixée 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. Unité : nombre Statistiques valides : `Sum,Average`
ResponseTime	Durée en millisecondes nécessaire à Rekognition pour calculer la réponse. Unités : Nombre de statistiques `Data Samples` Millisecondes pour les statistiques `Average` Statistiques valides : `Data Samples,Average` Note Le`ResponseTime`la métrique n'est pas incluse dans le volet métrique de Rekognition.
DetectedFaceCount	Nombre de visages détectés avec l'opération `IndexFaces` ou `DetectFaces`. Unité : nombre Statistiques valides : `Sum,Average`
DetectedLabelCount	Nombre d'étiquettes détectées avec l'opération `DetectLabels`. Unité : nombre 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. Unité : nombre 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. Unité : nombre Statistiques valides : `Sum,Average`
MinInferenceUnits	Le nombre minimal d'unités d'inférence spécifié lors du`StartProjectVersion`demande. Unité : nombre Statistiques valides : `Average`
MaxInferenceUnits	Le nombre maximum d'unités d'inférence spécifié lors du`StartProjectVersion` demande. Unité : nombre Statistiques valides : `Average`
DesiredInferenceUnits	Le nombre d'unités d'inférence auxquelles Rekognition augmente ou diminue. Unité : nombre Statistiques valides : `Average`
InServiceInferenceUnits	Le nombre d'unités d'inférence utilisées par le modèle. Unité : nombre Statistiques valides : `Average` 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

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 mesures de 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. Unité : nombre Statistiques valides : `Sum,Average`
CallCount	Nombre d'opérations spécifiées effectuées dans votre compte. Statistiques valides : `Sum,Average`
ThrottledCount	Nombre de demandes limitées. La Rekognition limite une demande lorsqu'elle reçoit plus de demandes que la limite de transactions par seconde fixée 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. Unité : nombre 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. Unité : nombre 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. Unité : nombre Statistiques valides : `Sum,Average`

CloudWatch dimension pour Rekognition

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, voirDimensionsdans leAmazon CloudWatch Guide de l'utilisateur.

CloudWatch dimension pour les étiquettes personnalisées Rekognition

Le tableau suivant présente 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	Le nom de la version du projet Rekognition Custom Labels que vous avez créée avec`CreateProjectVersion`.