Surveillance d'Amazon Lex avec Amazon CloudWatch - Amazon Lex V1
CloudWatch Métriques pour Amazon LexAfficher les métriques Amazon LexCréation d'une alarmeMesures d'exécution pour Amazon LexMesures d'association de canaux pour Amazon LexStatistiques des journaux de conversation pour Amazon Lex

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

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 Lex avec Amazon CloudWatch

Pour suivre l'état de santé de vos robots Amazon Lex, utilisez Amazon CloudWatch. Avec CloudWatch, vous pouvez obtenir des statistiques pour les opérations Amazon Lex individuelles ou pour les opérations Amazon Lex mondiales pour votre compte. Vous pouvez également configurer des CloudWatch alarmes pour qu'elles soient averties lorsqu'une ou plusieurs mesures dépassent un seuil que vous définissez. Par exemple, vous pouvez surveiller le nombre de demandes envoyées à un bot sur une période particulière, voir la latence des demandes ayant abouti ou générer une alarme lorsque les erreurs dépassent un seuil.

CloudWatch Métriques pour Amazon Lex

Pour obtenir des statistiques relatives à vos opérations Amazon Lex, 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 Lex comporte trois dimensions :

    • BotAlias, BotName, Operation

    • BotAlias, BotName, InputMode, Operation

    • BotName, BotVersion, InputMode, Operation

  • Le nom de métrique (par exemple, MissedUtteranceCount ou RuntimeRequestCount).

Vous pouvez obtenir des statistiques pour Amazon Lex à l'aide deAWS Management Console, deAWS CLI, ou de l' CloudWatch API. Vous pouvez utiliser l' CloudWatch API via l'un des kits de développement logiciel (SDK) Amazon AWS ou les outils CloudWatch d'API. La console Amazon Lex affiche des graphiques basés sur les données brutes de l' CloudWatch API.

Vous devez disposer des CloudWatch autorisations appropriées pour surveiller Amazon Lex CloudWatch . Pour plus d'informations, consultez Authentification et contrôle d'accès pour Amazon CloudWatch dans le guide de CloudWatch l'utilisateur Amazon.

Afficher les métriques Amazon Lex

Consultez les métriques Amazon Lex à l'aide de la console Amazon Lex ou de la CloudWatch console.

Pour consulter les statistiques (console Amazon Lex)

  1. Connectez-vous à la console Amazon Lex AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lex/.

  2. Dans la liste des bots, sélectionnez celui dont vous souhaitez voir les métriques.

  3. Choisissez Surveillance. Les métriques sont affichées dans des graphiques.

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/.

  2. Choisissez Métriques, Toutes les métriques, puis AWS/Lex.

  3. Choisissez la dimension, le nom de la métrique, puis Ajouter au graphique.

  4. Choisissez une valeur pour la plage de dates. Le décompte de la métrique pour la plage de dates sélectionnée est affiché dans le graphique.

Création d'une alarme

Une CloudWatch alarme surveille une seule métrique sur une période spécifiée et exécute une ou plusieurs actions : envoyer une notification à une rubrique Amazon Simple Notification Service (Amazon SNS) ou à une politique Auto Scaling. L'action ou les actions sont basées sur la valeur de la métrique par rapport à un seuil donné sur un certain nombre de périodes que vous spécifiez. CloudWatchpeut également vous envoyer un message Amazon SNS lorsque l'alarme change d'état.

CloudWatch les alarmes appellent des actions uniquement lorsque l'état change et persiste pendant la période que vous spécifiez.

Pour définir une alarme

  1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Choisissez Alarmes, puis Créer une alarme.

  3. Choisissez AWS/Lex Metrics, puis sélectionnez une métrique.

  4. Pour Période, choisissez un intervalle de temps à surveiller, puis cliquez sur Suivant.

  5. Saisissez un Name (Nom) et une Description.

  6. Pour Lorsque, choisissez >=, puis saisissez une valeur maximale.

  7. Si vous souhaitez CloudWatch envoyer un e-mail lorsque l'état d'alarme est atteint, dans la section Actions, pour Chaque fois que cette alarme est atteinte, choisissez State is ALARM. Pour Envoyer les notifications à, choisissez une liste de diffusion ou cliquez sur Nouvelle liste pour en créer une.

  8. Affichez un aperçu de l’alarme dans la section Aperçu de l’alarme. Si elle vous convient, choisissez Créer une alarme.

CloudWatchMétriques pour Amazon Lex Runtime

Le tableau suivant décrit les métriques d'exécution d'Amazon Lex.

Métrique Description
KendraIndexAccessError

Le nombre de fois où Amazon Lex n'a pas pu accéder à votre index Amazon Kendra.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

Unité : nombre
KendraLatency

Le temps nécessaire à Amazon Kendra pour répondre à une demande du. AMAZON.KendraSearchIntent

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

Dimensions valides pour l'opération PostText :

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

Unité : millisecondes
KendraSuccess

Le nombre de demandes réussies depuis votre index Amazon Kendra. AMAZON.KendraSearchIntent

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

Dimensions valides pour l'opération PostText :

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

Unité : nombre
KendraSystemErrors

Le nombre de fois où Amazon Lex n'a pas pu interroger l'index Amazon Kendra.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

Unité : nombre
KendraThrottledEvents

Le nombre de fois où Amazon Kendra a limité les demandes provenant du. AMAZON.KendraSearchIntent

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

Unité : nombre
MissedUtteranceCount

Nombre d'énoncés qui n'ont pas été reconnus au cours de la période spécifiée.

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

Dimensions valides pour l'opération PostText :

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

RuntimeConcurrency

Nombre de connexions simultanées au cours de la période spécifiée. RuntimeConcurrencyest signalé sous la forme d'unStatisticSet.

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • Fonctionnement BotName, BotVersion, InputMode

  • Fonctionnement BotName, BotAlias, InputMode

Dimensions valides pour les autres opérations :

  • Fonctionnement BotName, BotVersion

  • Fonctionnement BotName, BotAlias

Unité : nombre
RuntimeInvalidLambdaResponses

Nombre de réponses non valides AWS Lambda (Lambda) au cours de la période spécifiée.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation
RuntimeLambdaErrors

Nombre d'erreurs d'exécution Lambda au cours de la période spécifiée.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation
RuntimePollyErrors

Le nombre de réponses Amazon Polly non valides au cours de la période spécifiée.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation
RuntimeRequestCount

Nombre de demandes d'exécution au cours de la période spécifiée.

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

Dimensions valides pour l'opération PostText :

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

Unité : nombre
RuntimeSucessfulRequestLatency
Important

Cette métrique l'est RuntimeSucessfulRequestLatency et ne l'est pasRuntimeSuccessfulRequestLatency.

Temps de latence pour les demandes ayant abouti entre le moment où la demande a été effectuée et celui où la réponse a été renvoyée.

Dimensions valides pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

Dimensions valides pour l'opération PostText :

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

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.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

Unité : nombre
RuntimeThrottledEvents

Nombre de demandes limitées. Amazon Lex limite une demande lorsqu'il reçoit un nombre de demandes supérieur à 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.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Opération, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

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.

Dimension valide pour l'opération PostContent avec l'attribut InputMode Text ou Speech :

  • BotName, BotAlias, Operation, InputMode

Dimension valide pour l'opération PostText :

  • BotName, BotAlias, Operation

Unité : nombre

Les métriques d'exécution Amazon Lex utilisent l'AWS/Lexespace de noms et fournissent des métriques dans les dimensions suivantes. Vous pouvez regrouper les métriques par dimensions dans la CloudWatch console :

Dimension Description
BotName, BotAlias, Operation, InputMode Regroupe les métriques en fonction de l'alias du bot, du nom du bot, de l'opération (PostContent) et du type d'entrée (texte ou voix).
BotName, BotVersion, Operation, InputMode Regroupe les métriques en fonction du nom du bot, de la version du bot, de l'opération (PostContent) et du type d'entrée (texte ou voix).
BotName, BotVersion, Operation Regroupe les métriques en fonction du nom du bot, de la version du bot et de l'opération, PostText.
BotName, BotAlias, Operation Regroupe les métriques en fonction du nom du bot, de l'alias du bot et de l'opération, PostText.

CloudWatch Mesures relatives aux associations de canaux Amazon Lex

Une association de canal est l'association entre Amazon Lex et un canal de messagerie, tel que Facebook. Le tableau suivant décrit les métriques d'association de canaux Amazon Lex.

Métrique Description
BotChannelAuthErrors

Nombre d'erreurs d'authentification renvoyées par le canal de messagerie au cours de la période spécifiée. Une erreur d'authentification indique que le jeton secret fourni au cours de la création du canal n'est pas valide ou qu'il a expiré.

BotChannelConfigurationErrors

Nombre d'erreurs de configuration au cours de la période spécifiée. Une erreur de configuration indique qu'au moins une entrée de configuration du canal n'est pas valide.
BotChannelInboundThrottledEvents

Le nombre de fois où les messages envoyés par le canal de messagerie ont été limités par Amazon Lex au cours de la période spécifiée.

BotChannelOutboundThrottledEvents

Le nombre de fois où les événements sortants d'Amazon Lex vers le canal de messagerie ont été limités au cours de la période spécifiée.
BotChannelRequestCount

Nombre de demandes effectuées sur un canal au cours de la période spécifiée.
BotChannelResponseCardErrors

Le nombre de fois où Amazon Lex n'a pas pu publier de cartes-réponses au cours de la période spécifiée.
BotChannelSystemErrors

Nombre d'erreurs internes survenues dans Amazon Lex pour un canal au cours de la période spécifiée.

Les métriques d'association de canaux Amazon Lex utilisent l'AWS/Lexespace de noms et fournissent des métriques pour la dimension suivante. Vous pouvez regrouper les métriques par dimensions dans la CloudWatch console :

Dimension Description
BotAlias, BotChannelName, BotName, Source Regrouper les métriques en fonction de l'alias du bot, du nom du canal, du nom du bot et de la source du trafic.

CloudWatch Indicateurs pour les journaux de conversation

Amazon Lex utilise les statistiques suivantes pour la journalisation des conversations :

Métrique Description
ConversationLogsAudioDeliverySuccess

Nombre de journaux audio remis avec succès au compartiment S3 au cours de la période spécifiée.

Unités : nombre
ConversationLogsAudioDeliveryFailure

Nombre de journaux audio qui n'ont pas pu être remis au compartiment S3 au cours de la période spécifiée. Un échec de remise indique une erreur liée aux ressources configurées pour les journaux de conversation. Les erreurs peuvent inclure des autorisations IAM insuffisantes, une AWS KMS clé inaccessible ou un compartiment S3 inaccessible.

Unités : nombre
ConversationLogsTextDeliverySuccess

Le nombre de journaux de texte envoyés avec succès à CloudWatch Logs au cours de la période spécifiée.

Unités : nombre
ConversationLogsTextDeliveryFailure

Le nombre de journaux de texte qui n'ont pas pu être remis à CloudWatch Logs au cours de la période spécifiée. Un échec de remise indique une erreur liée aux ressources configurées pour les journaux de conversation. Les erreurs peuvent inclure des autorisations IAM insuffisantes, une AWS KMS clé inaccessible ou un groupe de CloudWatch journaux Logs inaccessible.

Unités : nombre

Les métriques du journal de conversation Amazon Lex utilisent l'AWS/Lexespace de noms et fournissent des métriques pour les dimensions suivantes. Vous pouvez regrouper les métriques par dimension dans la CloudWatch console.

Dimension Description

BotAlias

Regrouper les métriques par l'alias du bot.

BotName

Regrouper les métriques par le nom du bot.

BotVersion

Regrouper les métriques par la version du bot.