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 Translate
La surveillance joue un rôle important dans le maintien de la fiabilité, de la disponibilité et des performances d'Amazon Translate et de vos solutions. AWS fournit différents outils que vous pouvez utiliser pour surveiller Amazon Translate. Vous pouvez configurer certains de ces outils afin de surveiller pour vous vos solutions. Nous vous recommandons d’automatiser le plus possible les tâches de supervision.
Amazon Translate fournit des graphiques préconfigurés qui vous indiquent les indicateurs les plus importants pour votre solution. Chaque graphique propose une fenêtre sur les performances de votre solution. Pour obtenir des vues différentes sur la façon dont votre solution s'exécute avec le temps, vous pouvez modifier la plage de temps affichée par les graphiques.
Vous pouvez également utiliser Amazon CloudWatch pour surveiller Amazon Translate. Avec CloudWatch, vous pouvez automatiser la surveillance de mesures spécifiques pour vos solutions. Vous recevez une notification chaque fois qu'une métrique dépasse les seuils définis. Vous pouvez également utiliser l' CloudWatch API pour créer une application de surveillance personnalisée adaptée à vos besoins. Pour plus d'informations, consultez la section [Qu'est-ce qu'Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*.
Le tableau suivant décrit chacun des graphiques préconfigurés fournis par Amazon Translate.
| Graphe | Description |
| --- | --- |
| ![\[Graphique montrant le nombre de demandes réussies.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-successful-request-count.png) | Nombre de demandes réussies Le nombre de demandes réussies adressées à Amazon Translate au cours de la période spécifiée. |
| ![\[Graphique montrant le nombre limité de demandes.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-throttled-request-count.png) | Nombre de demandes limitéesLe nombre de demandes adressées à Amazon Translate qui ont été limitées au cours de la période spécifiée. Utilisez ces informations pour déterminer si votre application envoie des demandes à Amazon Translate trop rapidement. |
| ![\[Graphique montrant le temps de réponse moyen.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-average-response-time.png) | Temps de réponse moyen Le temps moyen nécessaire à Amazon Translate pour traiter votre demande au cours de la période spécifiée. |
| ![\[Graphique montrant le nombre de caractères.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-character-count.png) | Nombre de caractèresLe nombre total de caractères que vous avez envoyés à Amazon Translate pendant la période spécifiée. Il s'agit du nombre de caractères qui vous sera facturé. |
| ![\[Graphique montrant le nombre d'erreurs des utilisateurs.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-user-error-count.png) | Nombre d'erreurs utilisateurNombre d'erreurs utilisateur qui se sont produites pendant la période spécifiée. Les erreurs utilisateur se trouvent dans la plage des codes d'erreur HTTP comprise entre 400 et 499. |
| ![\[Graphique montrant le nombre d'erreurs du système.\]](http://docs.aws.amazon.com/fr_fr/translate/latest/dg/images/metric-system-error-count.png) | Nombre d'erreurs systèmeNombre d'erreurs système qui se sont produites pendant la période spécifiée. Les erreurs système se trouvent dans la plage des codes d'erreur HTTP comprise entre 500 et 599. |
## Surveillance d'Amazon Translate
Avec Amazon CloudWatch, vous pouvez obtenir des statistiques pour des opérations Amazon Translate individuelles ou des statistiques Amazon Translate globales pour votre compte. Utilisez des métriques pour suivre l'état de santé de vos solutions Amazon Translate et pour configurer des alarmes afin de vous avertir lorsqu'une ou plusieurs métriques dépassent un seuil défini. Par exemple, vous pouvez surveiller le nombre de demandes adressées à Amazon Translate au cours d'une période donnée, voir le temps de latence des demandes ou déclencher une alarme lorsque les erreurs dépassent un certain seuil.
### Comprendre CloudWatch les métriques pour Amazon Translate
Pour obtenir des statistiques relatives à vos opérations Amazon Translate, vous devez spécifier les informations suivantes :
+ La dimension de métrique. Une *dimension* est un ensemble de paires nom-valeur qui vous permet d’identifier une métrique. Amazon Translate comporte deux dimensions :
+ `Operation`
+ `Language pair`
+ Le nom de métrique (par exemple, `SuccessfulRequestCount` ou `RequestCharacters`). Pour obtenir une liste complète des métriques, consultez [CloudWatch Statistiques pour Amazon Translate](translate-cloudwatch.md#translate-cloudwatch-metrics).
Vous pouvez obtenir des statistiques pour Amazon Translate à l'aide de l'API AWS Management Console AWS CLI, de l'API ou de l' CloudWatch API. Vous pouvez utiliser l' CloudWatchAPI via l'un des kits de développement logiciel Amazon AWS (SDKs) ou les outils CloudWatch d'API.
Le tableau suivant répertorie certaines utilisations courantes des CloudWatch métriques. Voici quelques suggestions pour vous aider à démarrer, qui ne forment pas une liste exhaustive.
| Comment... ? | Surveillez cette métrique |
| --- | --- |
| Suivez le nombre de demandes réussies | Statistique sum de la métrique SuccessfulRequestCount |
| Sachez si mon application a atteint son débit maximum | Statistique sum de la métrique ThrottledCount |
| Trouvez le temps de réponse pour mon application | Statistique average de la métrique ResponseTime |
| Trouvez le nombre d'erreurs pour mon application | Statistique sum des métriques ServerErrorCount et UserErrorCount |
| Recherchez le nombre de caractères facturables | Statistique sum de la métrique CharacterCount |
Vous devez disposer des CloudWatch autorisations appropriées pour surveiller Amazon Translate. 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) dans le *guide de CloudWatch l'utilisateur Amazon*.
### Afficher les statistiques d'Amazon Translate
Consultez les statistiques d'Amazon Translate dans la CloudWatch console.
**Pour consulter les métriques (CloudWatch 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**, **Toutes les métriques**, puis **AWS/Translate**.
1. Choisissez la dimension, le nom de la métrique, puis **Ajouter au graphique**.
1. Choisissez une valeur pour la plage de dates. Le nombre de métriques pour la plage de dates spécifiées est affiché dans le graphique.
# Journalisation des appels d'API Amazon Translate avec AWS CloudTrail
Amazon Translate est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par une entité ou un AWS service IAM dans Amazon Translate. CloudTrail capture tous les appels d'API pour Amazon Translate sous forme d'événements. Cela inclut les appels depuis la console Amazon Translate et les appels de code vers les opérations de l'API Amazon Translate. Si vous créez un suivi CloudTrail , vous pouvez activer la diffusion continue des CloudTrail événements, y compris des événements pour Amazon Translate, vers un bucket Amazon Simple Storage Service (Amazon S3). Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans **Historique des événements**. Vous pouvez utiliser les informations collectées par CloudTrail pour déterminer la demande envoyée à Amazon Translate, l'adresse IP à partir de laquelle la demande a été faite, l'auteur de la demande, la date à laquelle elle a été faite, ainsi que des informations supplémentaires.
Pour en savoir plus CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
**Topics**
+ [Informations Amazon Translate en CloudTrail](#translate-info-in-cloudtrail)
+ [Comprendre les entrées du fichier journal Amazon Translate](#understanding-translate-entries)
## Informations Amazon Translate en CloudTrail
CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsqu'une activité se produit dans Amazon Translate, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans **l'historique des événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section [Affichage des événements à l'aide de l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Pour un enregistrement continu des événements de votre AWS compte, y compris des événements pour Amazon Translate, créez un historique. Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal de suivi avec la console, celui-ci s'applique à toutes les régions AWS. Le journal d’activité consigne les événements de toutes les régions dans la partition AWS et livre les fichiers journaux dans le compartiment S3 de votre choix. Vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes :
+ [Présentation de la création d’un journal de suivi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [ CloudTrail Services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [réception de fichiers CloudTrail journaux de](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) plusieurs comptes
Toutes les actions Amazon Translate sont enregistrées CloudTrail et documentées dans la [section de référence de l'API](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html). Par exemple, les appels au`DeleteTerminology`, `ImportTerminology` et les `TranslateText` actions génèrent des entrées dans les fichiers CloudTrail journaux.
Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Cette information permet de déterminer les éléments suivants :
+ Si la demande a été faite avec les informations d'identification de l'utilisateur root
+ Si la demande a été effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré
+ Si la demande a été faite par un autre AWS service
Pour de plus amples informations, veuillez consulter l'[élément userIdentity CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Comprendre les entrées du fichier journal Amazon Translate
Un *suivi* est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.
L'exemple suivant montre une entrée de CloudTrail journal illustrant l'`TranslateText`action.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/Administrator",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "Administrator"
},
"eventTime": "2019-09-03T20:32:50Z",
"eventSource": "translate.amazonaws.com",
"eventName": "TranslateText",
"awsRegion": "us-west-2",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197",
"requestParameters": {
"text": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"responseElements": {
"translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"requestID": "f56da956-284e-4983-b6fc-59befa20e2bf",
"eventID": "1dc75278-84d7-4bb2-861a-493d08d67391",
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# CloudWatch statistiques et dimensions pour Amazon Translate
Pour surveiller les performances de votre solution, utilisez les CloudWatch métriques et dimensions Amazon pour Amazon Translate.
## CloudWatch Statistiques pour Amazon Translate
| Métrique | Description |
| --- | --- |
| CharacterCount | Le nombre de caractères facturables dans les demandes. Dimensions valides : Paire de langues, opération Statistiques valides : Moyenne, maximum, minimum et somme Unité : nombre |
| ResponseTime | Le temps nécessaire pour répondre à une demande. Dimensions valides : Paire de langues, opération Statistiques valides : Exemples de données, moyenne Unité : Pour les échantillons de données, comptez. Pour les statistiques moyennes, millisecondes |
| ServerErrorCount | Nombre d’erreurs de serveur. La plage des codes de réponse HTTP d'une erreur de serveur est comprise entre 500 et 599. Dimension valide : Opération Statistiques valides : Moyenne, somme Unité : nombre |
| SuccessfulRequestCount | Le nombre de demandes de traduction réussies. La plage des codes de réponse d'une demande réussie est comprise entre 200 et 299. Dimension valide : Opération Statistiques valides : Moyenne, somme Unité : nombre |
| ThrottledCount | Le nombre de demandes soumises à la limitation. `ThrottledCount`À utiliser pour déterminer si votre application envoie des demandes à Amazon Translate plus rapidement que votre compte n'est configuré pour les accepter. Pour plus d'informations, consultez [Limites Amazon Translate](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate) dans le *Référence générale d'Amazon Web Services*. Dimension valide : Opération Statistiques valides : Moyenne, somme Unité : nombre |
| UserErrorCount | Nombre d'erreurs utilisateur survenues. La plage des codes de réponse HTTP d'une erreur utilisateur est comprise entre 400 et 499. Dimension valide : Opération Statistiques valides : Moyenne, somme Unité : nombre |
## CloudWatch Dimensions pour Amazon Translate
Utilisez les dimensions suivantes pour filtrer les métriques Amazon Translate. Les métriques sont regroupées par la langue source et la langue cible.
| Dimension | Description |
| --- | --- |
| LanguagePair | Limite les métriques uniquement à celles qui contiennent les langues spécifiées. |
| Operation | Limite les métriques uniquement à celles contenant l'opération spécifiée. |
# Surveillance des événements Amazon Translate avec Amazon EventBridge
Amazon Translate s'intègre EventBridge à Amazon pour vous informer des modifications qui affectent vos tâches de traduction et vos ressources de données parallèles. Les événements AWS liés aux services sont diffusés EventBridge en temps quasi réel. Vous pouvez écrire des règles simples pour indiquer quels événements vous intéressent et les actions automatisées à effectuer quand un événement correspond à une règle. Par exemple, les actions qui peuvent être lancées automatiquement incluent :
+ Invoquer une fonction AWS Lambda
+ Invocation de la commande Run de AWS Systems Manager
+ Relais de l’événement à Amazon Kinesis Data Streams
+ Activation d'une machine à AWS Step Functions états
+ Notification d’une rubrique Amazon SNS ou d’une file d’attente Amazon SQS
Pour plus d'informations, consultez [la section Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
## Événements Amazon Translate
Voici des exemples d'événements issus d'Amazon Translate.
### Événements relatifs aux tâches de traduction par lots
Vous exécutez des tâches de traduction par lots à l'aide de la console Amazon Translate ou de l'[StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)opération. Amazon Translate envoie des événements lorsque ces tâches sont terminées, avec ou sans succès. Ces événements ressemblent à l'exemple suivant.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate TextTranslationJob State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [],
"detail": {
"jobId": "01234567-0123-0123-0123-012345678901",
"jobStatus": "STATUS"
}
}
```
La valeur de l'`jobStatus`attribut dépend de l'état de la tâche pour lequel Amazon Translate a envoyé l'événement. Les valeurs de `jobStatus` sont :
+ `COMPLETED`— La tâche s'est terminée avec succès et le résultat est disponible.
+ `COMPLETED_WITH_ERROR`— Le travail s'est terminé avec des erreurs. Les erreurs peuvent être analysées dans le résultat de la tâche.
+ `STOPPED`— Le travail a été arrêté.
+ `FAILED`— Le travail n'a pas été terminé. Pour obtenir des informations détaillées, utilisez l'[DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)opération.
### Événements pour les ressources de données parallèles
Lorsque vous utilisez Amazon Translate pour créer ou mettre à jour une ressource de données parallèle, un événement est envoyé pour indiquer si l'opération a réussi ou échoué.
Vous créez des ressources de données parallèles à l'aide de la console Amazon Translate ou de l'[CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)opération. Dans ce cas, Amazon Translate envoie un événement tel que celui-ci.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "CreateParallelData",
"name": "ExampleParallelData",
"status": "STATUS"
}
}
```
Les valeurs de l'`status`attribut sont les suivantes :
+ `ACTIVE`— L'`CreateParallelData `opération a réussi et la ressource est prête à être utilisée.
+ `FAILED`— L'`CreateParallelData`opération a échoué.
Vous mettez à jour les ressources de données parallèles à l'aide de la console Amazon Translate ou de l'[UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)opération. Dans ce cas, Amazon Translate envoie un événement tel que celui-ci.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "UpdateParallelData",
"name": "ExampleParallelData",
"status": "STATUS",
"latestUpdateAttemptStatus": "STATUS",
"latestUpdateAttemptAt": "2017-04-22T03:31:47Z"
}
}
```
L'`status`attribut fournit l'état de la version précédente de la ressource de données parallèle, qui est remplacée par la mise à jour. Les valeurs sont les suivantes :
+ `ACTIVE`— La version précédente a été créée ou mise à jour avec succès.
+ `FAILED`— La version précédente n'a pas pu être créée ou mise à jour.
L'`latestUpdateAttemptStatus`attribut indique le statut de la nouvelle version de la ressource de données parallèle, créée par la mise à jour. Les valeurs sont les suivantes :
+ `ACTIVE`— L'`UpdateParallelData`opération a réussi et la ressource mise à jour est prête à être utilisée.
+ `FAILED`— L'`UpdateParallelData`opération a échoué.