Configuração de logs de conversas para seu bot do Lex V2 - Guia do desenvolvedor
Ativar logs de conversaComo desabilitar logs de conversas no Lex V2

Configuração de logs de conversas para seu bot do Lex V2

Habilite e desabilite os logs de conversa usando o console ou o campo conversationLogSettings da operação CreateBotAlias ou UpdateBotAlias. É possível ativar ou desativar logs de áudio, logs de texto ou ambos. O registro em log começa em novas sessões do bot. As alterações nas configurações de log não são refletidas nas sessões ativas.

Para armazenar logs de texto, use um grupo de logs do Amazon CloudWatch Logs em sua conta da AWS. É possível usar qualquer grupo de logs válido. O grupo de logs deve estar na mesma região que o bot do Amazon Lex V2. Para mais informações sobre a criação do grupo de logs do CloudWatch Logs, consulte Como trabalhar com grupos de logs e fluxos de logs no Guia do usuário do Amazon CloudWatch Logs.

Para armazenar logs de áudio, use um bucket do Amazon S3 em sua conta da AWS. É possível usar qualquer bucket válido do S3. O bucket deve estar na mesma região que o bot do Amazon Lex V2. Para mais informações sobre como criar um bucket do Amazon S3, consulte Criar um bucket no Guia de conceitos básicos do Amazon Simple Storage Service.

Quando você gerencia logs de conversas usando o console, o console atualiza seu perfil de serviço para que tenha acesso ao grupo de logs e ao bucket do S3.

Se você não estiver usando o console, é necessário fornecer um perfil do IAM com políticas que permitam ao Amazon Lex V2 gravar no grupo de logs ou no bucket configurado. Se criar um perfil vinculada ao serviço usando a AWS Command Line Interface, você deverá adicionar um sufixo personalizado ao perfil usando a opção custom-suffix no exemplo a seguir: Para obter mais informações, consulte Criar um perfil e políticas do IAM para logs de conversa.

aws iam create-service-linked-role \
    --aws-service-name lexv2.amazon.aws.com \
    --custom-suffix suffix

O perfil do IAM utilizado 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"
        }
    ]
}

Ativar logs de conversa

Para ativar os logs usando o console

  1. Abra o console do Amazon Lex V2 em https://console.aws.amazon.com/lexv2.

  2. Na lista, escolha um bot.

  3. No menu à esquerda, selecione Aliases.

  4. Na lista de aliases, escolha o alias para o qual você deseja configurar logs de conversa.

  5. Na seção Logs de conversas, escolha Gerenciar logs de conversas.

  6. Para logs de texto, selecione Habilitar insira o nome do grupo de logs do Amazon CloudWatch Logs.

  7. Para logs de áudio, escolha Ativar e, em seguida, insira as informações do bucket do S3.

  8. Opcional. Para criptografar logs de áudio, escolha a chave do AWS KMS a ser usada para criptografia.

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

Como desabilitar logs de conversas no Lex V2

Como desativar os logs usando o console

  1. Abra o console do Amazon Lex V2 em https://console.aws.amazon.com/lexv2.

  2. Na lista, escolha um bot.

  3. No menu à esquerda, selecione Aliases.

  4. Na lista de aliases, escolha o alias para o qual você deseja configurar logs de conversa.

  5. Na seção Logs de conversas, escolha Gerenciar logs de conversas.

  6. Desative o log de texto, log de áudio ou ambos para desativar a criação de logs.

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