Surveillance de Amazon Textract

Avec CloudWatch, vous pouvez obtenir des métriques relatives à des opérations individuelles Amazon Textract ou globales pour votre compte. Vous pouvez utiliser les métriques pour suivre l'état de votre solution basée sur Amazon Texact, et configurer des alarmes pour vous notifier lorsqu'une ou plusieurs métriques dépassent un seuil défini. Par exemple, vous pouvez afficher des métriques pour connaître le nombre d'erreurs serveur qui se sont produites. Vous pouvez également consulter les métriques pour obtenir le nombre de fois où une opération Amazon Textract spécifique a réussi. Pour afficher les métriques, vous pouvez utiliserAmazon CloudWatch, leAWS CLI, ou leAPI CloudWatch.

Utiliser CloudWatch pour Amazon Textract

Pour utiliser les métriques, vous devez spécifier les informations suivantes :

• La dimension de 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. Amazon Textract possède une dimension, nomméeOpé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 Amazon Textract au sein de votre compte.

• Le nom de la métrique, par exemple UserErrorCount.

Vous pouvez obtenir des données de surveillance pour Amazon Textract à l'aide duAWS Management Console, leAWS CLI, ou l'API CloudWatch. Vous pouvez également utiliser l'API CloudWatch via l'un des kits (SDK) Amazon AWS ou via les outils de l'API CloudWatch. La console affiche un ensemble de graphiques basés sur les données brutes obtenues avec l'API CloudWatch. 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 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 la statistique SampleCount 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 puis-je surveiller la latence des appels de l'opération Amazon Textract ?	Utilisez la métrique ResponseTime.

Vous devez avoir les autorisations CloudWatch appropriées pour surveiller Amazon Textract avec CloudWatch. Pour plus d'informations, consultez Authentification et contrôle d'accès pour Amazon CloudWatch Logs.

Accéder aux métriques Amazon Textract

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

Pour consulter les métriques (console)

1. Ouvrez la console CloudWatch à l'adresse https://console.aws.amazon.com/ CloudWatch/.

2. ChoisissezMétriques, choisissez leToutes les métriques, puis choisissezAmazon Textract.

3. ChoisissezPar opération, puis choisissez une métrique.

   Par exemple, choisissez leStartDocumentAnalysismesure le nombre de fois où l'analyse de documents asynchrone a été lancée.

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

Pour afficher des métriques de succèsStartDocumentAnalysisappels d'opération 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 2019-02-01T00:00:00Z \
      --period 3600 \
      --end-time 2019-03-01T00:00:00Z \
      --namespace AWS/Textract \
      --dimensions Name=Operation,Value=StartDocumentAnalysis \
      --statistics Sum

  Cet exemple illustre les appels réussis de l'opération StartDocumentAnalysis effectués sur une période de temps. Pour de plus amples informations, veuillez consulter get-metric-statistics.

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

• Appelez GetMetricStatistics. Pour plus d'informations, consultez le .Référence d'API Amazon CloudWatch.

Créer une alarme

Vous pouvez créer une alarme CloudWatch qui envoie un message Amazon Simple Notification Service (Amazon SNS) quand l'alarme change d'état. Une alarme surveille une seule métrique pendant 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 Amazon SNS ou à une stratégie Auto Scaling.

Les alarmes appellent les actions pour les changements d'état soutenus uniquement. Les alarmes CloudWatch ne déclenchent pas d'actions simplement parce qu'elles se trouvent 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 AWS Management Console et ouvrez la console CloudWatch à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le volet de navigation, choisissezAlarmes, et choisissezCréer une alarme. Cela ouvre leAssistant de création d'alarmes.

3. Choisissez Select metric (Sélectionner une métrique).

4. DansToutes les mesures, choisissezTextract.

5. ChoisissezPar opération, puis choisissez une métrique.

   Par exemple, choisissezStartDocumentAnalysispour définir une alarme pour un nombre maximal d'opérations d'analyse de documents asynchrone.

6. Sélectionnez l'onglet Graphed metrics (Graphiques des métriques).

7. Pour Statistics (Statistique), choisissez Sum (Somme).

8. Choisissez Select metric (Sélectionner une métrique).

9. Remplissez les champs Nom et Description. Pour Lorsque, choisissez >= et entrez une valeur maximale de votre choix.

10. Si vous voulez que CloudWatch vous envoie un e-mail quand l'état de l'alarme est atteint, pourÀ chaque fois que cette alarme :, choisissezL'état est ALARME. Pour envoyer des alarmes à une rubrique Amazon SNS existante, pourEnvoyer la notification à :, choisissez une rubrique SNS existante. Pour définir les noms et adresses de messagerie d'une nouvelle liste d'abonnement par e-mail, choisissez.Nouvelle liste. CloudWatch enregistre la liste et l'affiche dans le champ de telle sorte que vous puissiez l'utiliser pour définir de futures alarmes.

    Note

    Si vous utilisezNouvelle listePour créer une rubrique Amazon SNS, les adresses e-mail 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 e-mail, les destinataires prévus ne reçoivent pas de notification.

11. Choisissez Create Alarm (Créer l'alarme).

Pour définir une alarme (AWS CLI)

• Ouvrez l'AWS CLI et entrez la commande suivante. Modifier la valeur dualarm-actionspour faire référence à une rubrique Amazon SNS que vous avez précédemment créée.

  aws cloudwatch put-metric-alarm \
      --alarm-name StartDocumentAnalysisUserErrors \
      --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
      --metric-name UserErrorCount \
      --namespace AWS/Textract \
      --statistic Sum \
      --period 300 \
      --threshold 10 \
      --comparison-operator GreaterThanThreshold \
      --evaluation-periods 1 \
      --unit Count \
      --dimensions Name=Operation,Value=StartDocumentAnalysis \
      --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic 

  Cet exemple montre comment créer une alarme lorsque plus de 10 erreurs d'utilisateur se produisent dans un délai de 5 minutes pour les appels àStartDocumentAnalysis. Pour de plus amples informations, veuillez consulter put-metric-alarm.

Pour définir une alarme (API CloudWatch)

• Appelez PutMetricAlarm. Pour de plus amples informations, veuillez consulterRéférence d'API Amazon CloudWatch.