Registro em log de erros com logs de erro no Lex V2 - Guia do desenvolvedor

Registro em log de erros com logs de erro no Lex V2

Você habilita logs de erro para armazenar interações com o bot. Você pode usar esses logs de erro para examinar o desempenho do bot e solucionar erros com conversas.

Os logs de erro são configurados para uma versão. Cada versão pode ter configurações diferentes para os logs de erro. Os logs de texto armazenam entrada de texto no CloudWatch Logs. Você pode habilitar a criptografia dos logs de texto usando CMKs gerenciados pelo cliente do AWS KMS.

Políticas do IAM para logs de erro

Dependendo do tipo de criação de log selecionado, o Amazon Lex V2 requer permissão para usar o Amazon CloudWatch Logs e buckets do Amazon Simple Storage Service (S3) para armazenar os logs. É necessário criar permissões e perfis do AWS Identity and Access Management para permitir que o Amazon Lex V2 acesse esses atributos.

Criação de um perfil do IAM e políticas para logs de erro

Para habilitar logs de conversa, é necessário conceder permissão de gravação para o CloudWatch Logs e o Amazon S3. Se você habilitar a criptografia de objeto para seus objetos do S3, deverá conceder permissão de acesso às chaves do AWS KMS usadas para criptografar os objetos.

Você pode usar o console do IAM, a API do IAM ou AWS Command Line Interface para criar a função e as políticas. Essas instruções usam a AWS CLI para criar o perfil e as políticas.

Para criar um perfil do IAM para logs de erro

O perfil do IAM usado por você para habilitar logs de conversa deve ter a permissão iam:PassRole. A política a seguir deve ser anexada ao perfil:

JSON
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::111122223333:role/role" } ] }

Habilitação dos logs de erro no Lex V2

Para ativar logs de erro usando o console do Amazon Lex V2:

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. Na lista Bots, escolha o bot que você deseja habilitar para logs de erro.

  3. No menu à esquerda, escolha Versão.

  4. Na lista Versão, escolha a versão para a qual você deseja configurar logs de erro.

  5. Na seção Detalhes da versão, escolha Habilitar.

  6. Escolha Salvar para iniciar o registro em log de conversas. Se necessário, o Amazon Lex V2 atualizará o perfil de serviço com permissões para acessar o grupo de logs do CloudWatch Logs.

Desabilitação dos logs de erro no Lex V2

Para desativar logs de erro usando o console do Amazon Lex V2:

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. Na lista Bots, escolha o bot que você deseja habilitar para logs de erro.

  3. No menu à esquerda, escolha Versão.

  4. Na lista Versão, escolha a versão para a qual você deseja configurar logs de erro.

  5. Na seção Detalhes da versão, escolha Desabilitar.

  6. Escolha Salvar para interromper o registro em log de conversas.