Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Depois de 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 ou os recursos do Amazon Lex V1. Se você estiver usando o Amazon Lex V2, consulte o guia do Amazon Lex V2 em vez disso.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Monitorando o Amazon Lex com a Amazon CloudWatch
Para monitorar a saúde dos seus bots Amazon Lex, use a Amazon CloudWatch. Com CloudWatch, você pode obter métricas para operações individuais do Amazon Lex ou para operações globais do Amazon Lex para sua conta. Você também pode configurar CloudWatch alarmes para serem notificados quando uma ou mais métricas excederem um limite definido por você. Por exemplo, você pode monitorar o número de solicitações feitas a um bot durante um determinado período de tempo, visualizar a latência de solicitações bem-sucedidas ou gerar um alarme quando erros excederem um limite.
CloudWatch Métricas para o Amazon Lex
Para obter métricas para as operações do Amazon Lex, você deverá especificar as seguintes informações:
-
A dimensão da métrica. Uma dimensão é um conjunto de pares de nome-valor que você usa para identificar uma métrica. O Amazon Lex tem três dimensões:
-
BotAlias, BotName, Operation -
BotAlias, BotName, InputMode, Operation -
BotName, BotVersion, InputMode, Operation
-
-
O nome da métrica, como
MissedUtteranceCountouRuntimeRequestCount.
Você pode obter métricas para o Amazon Lex com a AWS Management Console AWS CLI, a ou a CloudWatch API. Você pode usar a CloudWatch API por meio de um dos kits de desenvolvimento de software da Amazon AWS (SDKs) ou das ferramentas de CloudWatch API. O console do Amazon Lex exibe gráficos com base nos dados brutos da CloudWatch API.
Você deve ter as CloudWatch permissões apropriadas para monitorar o Amazon Lex com CloudWatch . Para obter mais informações, consulte Autenticação e controle de acesso para a Amazon CloudWatch no Guia CloudWatch do usuário da Amazon.
Visualizar métricas do Amazon Lex
Veja as métricas do Amazon Lex usando o console do Amazon Lex ou o CloudWatch console.
Para visualizar métricas (console do Amazon Lex)
Faça login no AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/
. -
Na lista de bots, escolha aqueles cujas métricas você deseja ver.
-
Escolha Monitoramento. As métricas serão exibidos em gráficos.
Para visualizar métricas (CloudWatch console)
Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/
. -
Escolha Métricas, Todas as métricas e, em seguida, selecione AWS/Lex.
-
Escolha a dimensão, informe um nome de métrica e selecione Adicionar ao gráfico.
-
Escolha um valor para o intervalo de datas. A contagem da métrica para o intervalo de datas selecionado é exibida no gráfico.
Criar um alarme
Um CloudWatch alarme monitora uma única métrica durante um período de tempo especificado e executa uma ou mais ações: enviar uma notificação para um tópico do Amazon Simple Notification Service (Amazon SNS) ou política de Auto Scaling. A ação ou ações são baseadas no valor da métrica em relação a um determinado limite em vários períodos que você especifica. CloudWatchtambém pode enviar uma mensagem do Amazon SNS quando o alarme muda de estado.
CloudWatch os alarmes invocam ações somente quando o estado muda e persiste durante o período especificado.
Para definir um alarme
Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/
. -
Escolha Alarmes e, em seguida, Criar alarme.
-
Escolha Métricas do AWS/Lex e, em seguida, escolha uma métrica.
-
Para Intervalo de tempo, escolha um intervalo de tempo para monitorar e, em seguida, selecione Avançar.
-
Preencha os campos Nome e Descrição.
-
Para Sempre que, escolha >= e digite um valor máximo.
-
Se você quiser CloudWatch enviar um e-mail quando o estado do alarme for atingido, na seção Ações, para Sempre que este alarme for atingido, escolha Estado é ALARME. Em Enviar notificação para, selecione uma lista de correspondência ou selecione Nova lista e crie uma nova.
-
Visualize o alarme na seção Prévia do alarme. Se você estiver satisfeito com o alarme, selecione Criar alarme.
CloudWatchMétricas para o Amazon Lex Runtime
A tabela a seguir descreve as métricas de runtime para o Amazon Lex.
| Métrica | Descrição |
|---|---|
KendraIndexAccessError |
O número de vezes que o Amazon Lex não conseguiu acessar seu índice Amazon Kendra. Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
KendraLatency |
A quantidade de tempo que a Amazon Kendra leva para responder a uma solicitação do Dimensões válidas para a operação
Dimensões válidas para a operação
Unidade: milissegundos |
KendraSuccess |
O número de solicitações bem-sucedidas do índice do Dimensões válidas para a operação
Dimensões válidas para a operação
Unidade: contagem |
KendraSystemErrors |
O número de vezes que o Amazon Lex não conseguiu acessar seu índice Amazon Kendra. Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
KendraThrottledEvents |
O número de vezes que o Amazon Kendra controlou a utilização das solicitações do Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
MissedUtteranceCount |
O número de declarações que não foram reconhecidas no período especificado. Dimensões válidas para a operação
Dimensões válidas para a operação
|
|
|
O número de conexões simultâneas no período especificado. Dimensões válidas para a operação
Dimensões válidas para outras operações:
Unidade: contagem |
RuntimeInvalidLambdaResponses |
O número de respostas inválidas AWS Lambda (Lambda) no período especificado. Dimensão válida para a operação
Dimensão válida para a operação
|
RuntimeLambdaErrors |
O número de erros de runtime do Lambda no período especificado. Dimensão válida para a operação
Dimensão válida para a operação
|
RuntimePollyErrors |
O número de respostas inválidas do Amazon Polly no período especificado. Dimensão válida para a operação
Dimensão válida para a operação
|
RuntimeRequestCount |
O número de solicitações de runtime no período especificado. Dimensões válidas para a operação
Dimensões válidas para a operação
Unidade: contagem |
RuntimeSucessfulRequestLatency
ImportanteEssa métrica é |
A latência de solicitações bem-sucedidas entre o horário em que a solicitação foi feita e a resposta foi passada. Dimensões válidas para a operação
Dimensões válidas para a operação
Unidade: milissegundos |
RuntimeSystemErrors |
O número de erros do sistema no período especificado. O intervalo de códigos de resposta para um erro do sistema vai de 500 até 599. Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
RuntimeThrottledEvents |
O número de solicitações limitadas. O Amazon Lex controla a utilização de uma solicitação ao receber mais solicitações do que o limite de transações por segundo definido para a conta. Se o limite definido para a conta for frequentemente excedido, você poderá solicitar um aumento no limite. Para solicitar um aumento, consulte Limites de serviço da AWS. Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
RuntimeUserErrors |
O número de erros de usuário no período especificado. O intervalo de códigos de resposta para um erro de usuário vai de 400 até 499. Dimensão válida para a operação
Dimensão válida para a operação
Unidade: contagem |
As métricas de runtime do Amazon Lex usam o namespace do AWS/Lex e fornecem métricas nas dimensões a seguir. Você pode agrupar métricas por dimensões no CloudWatch console:
| Dimensão | Descrição |
|---|---|
BotName, BotAlias, Operation,
InputMode |
Agrupa as métricas por alias do bot, nome do bot, operação (PostContent) e se a entrada foi de texto ou fala. |
BotName, BotVersion, Operation,
InputMode |
Agrupa as métricas por nome do bot, versão do bot, operação (PostContent) e se a entrada foi de texto ou fala. |
BotName, BotVersion,
Operation |
Agrupa as métricas por nome do bot, versão do bot e operação, PostText. |
BotName, BotAlias,
Operation |
Agrupa as métricas por nome do bot, alias do bot e operação, PostText. |
CloudWatch Métricas para associações de canais do Amazon Lex
Uma associação de canal é aquela entre o Amazon Lex e um canal de mensagens, como o Facebook. A tabela a seguir descreve as métricas de associação de canal do Amazon Lex.
| Métrica | Descrição |
|---|---|
BotChannelAuthErrors |
O número de erros de autenticação retornado pelo canal de mensagens no período especificado. Um erro de autenticação indica que o token secreto fornecido durante a criação de canal é inválido ou expirou. |
BotChannelConfigurationErrors |
O número de erros de configuração no período especificado. Um erro de configuração indica que uma ou mais entradas de configuração para o canal são inválidas. |
BotChannelInboundThrottledEvents |
O número de vezes que as mensagens que foram enviadas pelo canal de mensagens foram limitadas pelo Amazon Lex no período especificado. |
BotChannelOutboundThrottledEvents |
O número de vezes que os eventos de saída do Amazon Lex para o canal de mensagens foram limitados no período de tempo especificado. |
BotChannelRequestCount |
O número de solicitações feitas em um canal no período especificado. |
BotChannelResponseCardErrors |
O número de vezes que o Amazon Lex não conseguiu publicar cartões de resposta no período especificado. |
BotChannelSystemErrors |
O número de erros internos que ocorreram no Amazon Lex para um canal no período especificado. |
As métricas de associação de canal do Amazon Lex usam o namespace do AWS/Lex e fornecem métricas para a dimensão a seguir. Você pode agrupar métricas por dimensões no CloudWatch console:
| Dimensão | Descrição |
|---|---|
BotAlias, BotChannelName, BotName,
Source |
Agrupar as métricas por alias do bot, nome do canal, nome do bot e origem do tráfego. |
CloudWatch Métricas para registros de conversas
O Amazon Lex usa as seguintes métricas para logs de conversa:
| Métrica | Descrição |
|---|---|
ConversationLogsAudioDeliverySuccess |
O número de logs de áudio entregues com êxito ao bucket do S3 no período especificado. Unidades: contagem |
ConversationLogsAudioDeliveryFailure |
O número de logs de áudio que não foram entregues ao bucket do S3 no período especificado. Uma falha de entrega indica um erro com os recursos configurados para logs de conversa. Os erros podem incluir permissões insuficientes do IAM, uma AWS KMS chave inacessível ou um bucket S3 inacessível. Unidades: contagem |
ConversationLogsTextDeliverySuccess |
O número de registros de texto entregues com sucesso ao CloudWatch Logs no período de tempo especificado. Unidades: contagem |
ConversationLogsTextDeliveryFailure |
O número de registros de texto que não foram entregues aos CloudWatch Registros no período de tempo especificado. Uma falha de entrega indica um erro com os recursos configurados para logs de conversa. Os erros podem incluir permissões insuficientes do IAM, uma AWS KMS chave inacessível ou um grupo de registros de CloudWatch registros inacessível. Unidades: contagem |
As métricas de log de conversa do Amazon Lex usam o namespace AWS/Lex e fornecem métricas para as dimensões a seguir. Você pode agrupar métricas por dimensão no CloudWatch console.
| Dimensão | Descrição |
|---|---|
|
Agrupe métricas pelo alias do bot. |
|
Agrupe métricas pelo nome do bot. |
|
Agrupe métricas pela versão do bot. |
