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 des métriques opérationnelles dans Lex V2
Amazon CloudWatch et AWS AWS CloudTrail sont deux services qui s'intègrent à Amazon Lex V2 pour vous aider à surveiller les interactions des utilisateurs avec votre bot. Utilisez ces services pour enregistrer les actions, envoyer des données en temps quasi réel et configurer des notifications et des actions automatisées lorsque les critères sont remplis.
**Topics**
+ [Mesurer les indicateurs opérationnels avec Amazon CloudWatch](monitoring-cloudwatch.md)
+ [Afficher des événements avec AWS CloudTrail for Lex V2](logging-using-cloudtrail.md)
# Mesurer les indicateurs opérationnels avec Amazon CloudWatch
Vous pouvez surveiller Amazon Lex V2 à l'aide d'Amazon Lex V2 CloudWatch, qui collecte les données brutes et les transforme en indicateurs lisibles en temps quasi réel. Ces statistiques sont enregistrées pour une durée de 15 mois ; par conséquent, vous pouvez accéder aux informations historiques et acquérir un meilleur point de vue de la façon dont votre service ou application web s’exécute. Vous pouvez également définir des alarmes qui surveillent certains seuils et envoient des notifications ou prennent des mesures lorsque ces seuils sont atteints. Pour plus d'informations, consultez le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Le service Amazon Lex V2 indique les métriques suivantes dans l'espace de `AWS/Lex` noms.
| Métrique | Description |
| --- | --- |
| `AssistedSlotResolutionModelAccessDeniedErrorCount` | Le nombre de fois où Amazon Lex V2 s'est vu refuser l'accès à Amazon Bedrock Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour `RecognizeText` : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `AssistedSlotResolutionModelInvocationCount` | Le nombre de fois où Amazon Bedrock a été invoqué. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour `RecognizeText` : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `AssistedSlotResolutionModelSystemErrorCount` | Le nombre de fois où un 5xx s'est produit lors d'un appel à Amazon Bedrock. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour `RecognizeText` : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `AssistedSlotResolutionModelThrottlingErrorCount` | Le nombre de fois où Amazon Lex a été limité par Amazon Bedrock. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour `RecognizeText` : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `AssistedSlotResolutionResolvedSlotCount` | Le nombre de fois où Amazon Bedrock a renvoyé une valeur de créneau. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour `RecognizeText` : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `KendraIndexAccessError` | Le nombre de fois où Amazon Lex V2 n'a pas pu accéder à votre index Amazon Kendra. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `KendraLatency` | Le temps nécessaire à Amazon Kendra pour répondre à une demande du. `AMAZON.KendraSearchIntent` Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : millisecondes |
| `KendraSuccess` | Le nombre de fois où Amazon Lex V2 n'a pas pu accéder à votre index Amazon Kendra. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `KendraSystemErrors` | Le nombre de fois où Amazon Lex V2 n'a pas pu interroger l'index Amazon Kendra. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `KendraThrottledEvents` | Le nombre de fois où Amazon Kendra a limité les demandes provenant du. `AMAZON.KendraSearchIntent` Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeConcurrency` | Nombre de connexions simultanées au cours de la période spécifiée. `RuntimeConcurrency`est signalé sous la forme d'un`StatisticSet`. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` or : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeInvalidLambdaResponses` | Le nombre de AWS Lambda réponses non valides au cours de la période spécifiée. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeLambdaErrors` | Nombre d'erreurs d'exécution Lambda au cours de la période spécifiée. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimePollyErrors` | Le nombre de réponses Amazon Polly non valides au cours de la période spécifiée. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeRequestCount` | Le nombre de demandes d'exécution au cours de la période spécifiée. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeRequestLength` | Durée totale d'une conversation avec un bot Amazon Lex V2. Applicable uniquement à l'[StartConversation](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_StartConversation.html)opération. Dimensions valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : millisecondes |
| `RuntimeSucessfulRequestLatency` Cette métrique l'est `RuntimeSucessfulRequestLatency` et ne l'est pas`RuntimeSuccessfulRequestLatency`. | Le temps de latence des demandes réussies entre le moment où la demande a été faite et le moment où la réponse a été renvoyée. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : millisecondes |
| `RuntimeSystemErrors` | Nombre d'erreurs système au cours de la période spécifiée. La plage des codes de réponse d'une erreur système est comprise entre 500 et 599. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeThrottledEvents` | Le nombre d'événements limités. Amazon Lex V2 limite un événement lorsqu'il reçoit plus de demandes 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 les [limites de service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
| `RuntimeUserErrors` | Nombre d'erreurs utilisateur au cours de la période spécifiée. La plage des codes de réponse d’une erreur d’utilisateur est comprise entre 400 et 499. Dimensions valides pour les `StartConversation` opérations `RecognizeUtterance` et : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Dimensions valides pour les autres opérations : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lexv2/latest/dg/monitoring-cloudwatch.html) Unité : nombre |
Les dimensions suivantes sont prises en charge pour les métriques Amazon Lex V2.
| Dimension | Description |
| --- | --- |
| Operation | Nom de l'opération Amazon Lex V2 —`RecognizeText`,`RecognizeUtterance`,`StartConversation`,`GetSession`,`PutSession`, `DeleteSession` — qui a généré l'entrée. |
| BotId | Identifiant unique alphanumérique du bot. |
| BotAliasId | Identifiant unique alphanumérique de l'alias du bot. |
| BotVersion | La version numérique du bot. |
| InputMode | Type de saisie du bot : voix, texte ou DTMF. |
| LocaleId | L'identifiant de la localisation du bot, tel que en-US ou fr-CA. |
| Model | Indique l'identifiant du modèle de langage large Amazon Bedrock. |
| ModelType | Indique le type de grand modèle de langage invoqué depuis Amazon Bedrock. |
# Afficher des événements avec AWS CloudTrail for Lex V2
Amazon Lex V2 est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions effectuées par un utilisateur, un rôle ou un service AWS dans Amazon Lex V2. CloudTrail capture les appels d'API pour Amazon Lex V2 sous forme d'événements. Les appels capturés incluent des appels provenant de la console Amazon Lex V2 et des appels de code vers les opérations de l'API Amazon Lex V2. Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour Amazon Lex V2. Si vous ne configurez pas de journal d'activité, vous pouvez toujours afficher les événements les plus récents dans la console CloudTrail dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande envoyée à Amazon Lex V2, 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/cloudtrail-user-guide.html).
## Informations sur Amazon Lex V2 dans CloudTrail
CloudTrail est activé sur votre compte AWS lorsque vous créez le compte. Lorsqu'une activité a lieu dans Amazon Lex V2, elle est enregistrée dans un CloudTrail événement avec les autres événements du service AWS dans **l'historique** des événements. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre compte AWS. 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 compte AWS, y compris des événements relatifs à Amazon Lex V2, créez un journal. Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d'activité dans la console, il s’applique à toutes les régions AWS. Le journal de suivi consigne les événements de toutes les régions dans la partition AWS et fournit les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d'autres services AWS pour analyser plus en profondeur les données d'événement collectées dans les journaux CloudTrail et agir sur celles-ci. 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)
+ [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.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 plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Amazon Lex V2 prend en charge la journalisation de toutes les actions répertoriées dans [l'API Model Building V2](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_Operations_Amazon_Lex_Model_Building_V2.html).
Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :
+ Si la demande a été faite avec les informations d'identification utilisateur root ou AWS Identity and Access Management IAM.
+ Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.
+ Si la requête a été effectuée par un autre service AWS.
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 Lex V2
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'[CreateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotAlias.html)action.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "AssumedRole",
"principalId": "ID of caller:temporary credentials",
"arn": "arn:aws:sts::111122223333:assumed-role/role name/role ARN",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "ID of caller",
"arn": "arn:aws:iam::111122223333:role/role name",
"accountId": "111122223333",
"userName": "role name"
},
"webIdFederationData": {},
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "creation date"
}
}
},
"eventTime": "event timestamp",
"eventSource": "lex.amazonaws.com",
"eventName": "CreateBotAlias",
"awsRegion": "Region",
"sourceIPAddress": "192.0.2.0",
"userAgent": "user agent",
"requestParameters": {
"botAliasLocaleSettingsMap": {
"en_US": {
"enabled": true
}
},
"botId": "bot ID",
"botAliasName": "bot aliase name",
"botVersion": "1"
},
"responseElements": {
"botAliasLocaleSettingsMap": {
"en_US": {
"enabled": true
}
},
"botAliasId": "bot alias ID",
"botAliasName": "bot alias name",
"botId": "bot ID",
"botVersion": "1",
"creationDateTime": creation timestamp
},
"requestID": "unique request ID",
"eventID": "unique event ID",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```