Configurar logs de conversa - Guia do desenvolvedor

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

Configurar logs de conversa

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 registros de texto, use um grupo de CloudWatch registros do Amazon Logs em sua AWS conta. É 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 obter mais informações sobre a criação de um grupo de CloudWatch registros de registros, consulte Como trabalhar com grupos de registros e fluxos de registros no Guia do usuário do Amazon CloudWatch Logs.

Para armazenar registros de áudio, use um bucket Amazon S3 em sua AWS conta. É 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 obter 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 você criar uma função vinculada ao serviço usando o AWS Command Line Interface, deverá adicionar um sufixo personalizado à função usando a custom-suffix opção, como no exemplo a seguir. Para ter 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:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::account: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 registros de texto, escolha Ativar e insira o nome do grupo de CloudWatch registros do Amazon Logs.

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

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

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

Desativar logs de conversa

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.