Configurar logs de conversa - Amazon Lex V1
Ativar logs de conversaDesativar logs de conversa

Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.

 

Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.

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 conversationLogs da operação PutBotAlias. É 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 do 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. Para obter 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 do AWS. É possível usar qualquer bucket válido do S3. O bucket deve estar na mesma região que o bot do Amazon Lex. 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.

É necessário fornecer um perfil do IAM com políticas que permitam ao Amazon Lex gravar no grupo de logs ou no bucket configurado. Para obter mais informações, consulte Criar um perfil e políticas do IAM para logs de conversa.

Se criar um perfil vinculada ao serviço usando o AWS Command Line Interface, você deverá adicionar um sufixo personalizado ao perfil usando a opção custom-suffix a seguir:

aws iam create-service-linked-role \
    --aws-service-name lex.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 em https://console.aws.amazon.com/lex.

  2. Na lista, escolha um bot.

  3. Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.

  4. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.

  5. Selecione se deseja registrar texto, áudio ou ambos.

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

  7. Para registro de áudio em log, 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 uma perfil do IAM com as permissões necessárias.

  10. Escolha Salvar para iniciar o registro em log de conversas.

Como ativar logs de texto usando a API

  1. Chame a operação PutBotAlias com uma entrada no membro logSettings do campo conversationLogs

    • Defina o membro destination como CLOUDWATCH_LOGS

    • Defina o membro logType como TEXT

    • Defina o membro de resourceArn como o nome de recurso da Amazon (ARN) do grupo de logs do CloudWatch Logs que é o destino dos logs

  2. Defina o membro iamRoleArn do campo conversationLogs como o nome de recurso da Amazon (ARN) de um perfil do IAM que tenha as permissões necessárias para habilitar logs de conversa nos atributos especificados.

Como ativar logs de áudio usando a API

  1. Chame a operação PutBotAlias com uma entrada no membro logSettings do campo conversationLogs

    • Defina o membro destination como S3

    • Defina o membro logType como AUDIO

    • Defina o membro resourceArn como o ARN do bucket do Amazon S3 onde os logs de áudio são armazenados

    • Opcional. Para criptografar logs de áudio com uma chave do AWS KMS específica, defina o membro kmsKeyArn do ARN da chave usada para criptografia.

  2. Defina o membro iamRoleArn do campo conversationLogs como o nome de recurso da Amazon (ARN) de um perfil do IAM que tenha as permissões necessárias para habilitar logs de conversa nos atributos especificados.

Desativar logs de conversa

Como desativar os logs usando o console

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

  2. Na lista, escolha um bot.

  3. Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.

  4. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.

  5. Desmarque a verificação de texto, áudio ou ambos para desativar o registro em log.

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

Como desativar os logs usando a API

  • Chame a operação PutBotAlias sem o campo conversationLogs.

Como desativar os logs de texto usando a API

    • Se você estiver registrando áudio

      • Chame a operação PutBotAlias com uma entrada logSettings somente para AUDIO.

      • A chamada para a operação PutBotAlias não deve ter uma entrada logSettings para TEXT.

    • Se você não estiver registrando áudio em log

      • Chame a operação PutBotAlias sem o campo conversationLogs.

Como desativar os logs de áudio usando a API

    • Se você estiver registrando texto em log

      • Chame a operação PutBotAlias com uma entrada logSettings somente para TEXT.

      • A chamada para a operação PutBotAlias não deve ter uma entrada logSettings para AUDIO.

    • Se você não estiver registrando texto em log

      • Chame a operação PutBotAlias sem o campo conversationLogs.