대화 로그 구성 - Amazon Lex V1
대화 로그 활성화대화 로그 비활성화

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

대화 로그 구성

콘솔 또는 PutBotAlias 작업의 conversationLogs 필드를 사용하여 대화 로그를 활성화 및 비활성화합니다. 오디오 로그, 텍스트 로그 또는 둘 다 설정하거나 해제할 수 있습니다. 새 봇 세션에서 로깅이 시작됩니다. 로그 설정에 대한 변경 사항은 활성 세션에 반영되지 않습니다.

텍스트 로그를 저장하려면 AWS 계정에서 Amazon CloudWatch Logs 로그 그룹을 사용합니다. 유효한 로그 그룹 어느 것이든 사용할 수 있습니다. 로그 그룹은 Amazon Lex 봇과 동일한 리전에 있어야 합니다. CloudWatch 로그 로그 그룹 생성에 대한 자세한 내용을 알아보려면 Amazon CloudWatch Logs 사용 설명서의 로그 그룹 및 로그 스트림 작업을 참조하세요.

오디오 로그를 저장하려면 AWS 계정에서 Amazon S3 버킷을 사용합니다. 유효한 S3 버킷 어느 것이든 사용할 수 있습니다. 버킷은 Amazon Lex 봇과 동일한 리전에 있어야 합니다. Amazon S3 버킷에 대한 자세한 내용은 Amazon Simple Storage Service 시작 가이드의 버킷 생성(Create a Bucket)을 참조하세요.

Amazon Lex가 구성된 로그 그룹 또는 버킷에 쓸 수 있도록 하는 정책을 IAM 역할 에 제공해야 합니다. 자세한 내용은 대화 로그에 대한 IAM 역할 및 정책 생성 섹션을 참조하세요.

AWS Command Line Interface를 사용하여 서비스 연결 역할을 생성하는 경우 다음과 같이 custom-suffix 옵션을 사용하여 역할에 사용자 지정 접미사를 추가해야 합니다. 

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

대화 로그를 활성화하는 데 사용하는 IAM 역할에 iam:PassRole 권한이 있어야 합니다. 다음 정책이 역할에 연결되어야 합니다.

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

대화 로그 활성화

콘솔을 사용하여 로그를 활성화하려면

  1. https://console.aws.amazon.com/ecs/v2에서 Amazon Lex 콘솔을 엽니다.

  2. 목록에서 봇을 선택합니다.

  3. 설정 탭을 선택한 다음 왼쪽 메뉴에서 대화 로그)를 선택합니다.

  4. 별칭 목록에서 대화 로그를 구성할 별칭의 설정 아이콘을 선택합니다.

  5. 텍스트, 오디오 또는 둘 다 기록할지 선택합니다.

  6. 텍스트 로깅의 경우 Amazon CloudWatch Logs 로그 그룹 이름을 입력합니다.

  7. 오디오 로깅의 경우 S3 버킷 정보를 입력합니다.

  8. 선택 사항. 오디오 로그를 암호화하려면 암호화에 사용할 AWS KMS 키를 선택합니다.

  9. 필요한 권한이 있는 IAM 역할을 선택합니다.

  10. 저장을 선택하여 대화 로깅을 시작합니다.

API를 사용한 텍스트 로그를 활성화하려면

  1. conversationLogs 필드의 logSettings 멤버에 있는 항목으로 PutBotAlias 작업을 호출합니다.

    • destination 멤버를 CLOUDWATCH_LOGS로 설정

    • logType 멤버를 TEXT로 설정

    • resourceArn 멤버를 로그의 대상인 CloudWatch 로그 로그 그룹의 Amazon 리소스 이름(ARN)으로 설정

  2. conversationLogs 필드의 iamRoleArn 멤버를 IAM 역할(특정한 리소스의 대화 로그를 활성화할 수 있는 필수 권한을 가진)의 Amazon 리소스 이름(ARN)으로 설정합니다.

API를 사용하여 오디오 로그를 설정하려면

  1. conversationLogs 필드의 logSettings 멤버에 있는 항목으로 PutBotAlias 작업을 호출합니다.

    • destination 멤버를 S3로 설정

    • logType 멤버를 AUDIO로 설정

    • resourceArn 멤버를 오디오 로그가 저장된 Amazon S3 버킷의 ARN으로 설정

    • 선택 사항. 특정한 AWS KMS 키로 오디오 로그를 암호화하려면 kmsKeyArn 멤버를 암호화에 사용된 키의 ARN으로 설정합니다.

  2. conversationLogs 필드의 iamRoleArn 멤버를 IAM 역할(특정한 리소스의 대화 로그를 활성화할 수 있는 필수 권한을 가진)의 Amazon 리소스 이름(ARN)으로 설정합니다.

대화 로그 비활성화

콘솔을 사용하여 로그를 해제하려면

  1. https://console.aws.amazon.com/lex에서 Amazon Lex 콘솔을 엽니다.

  2. 목록에서 봇을 선택합니다.

  3. 설정 탭을 선택한 다음 왼쪽 메뉴에서 대화 로그를 선택합니다.

  4. 별칭 목록에서 대화 로그를 구성할 별칭의 설정 아이콘을 선택합니다.

  5. 로깅을 해제하려면 텍스트, 오디오 또는 둘 다의 선택을 취소합니다.

  6. 대화 로깅을 중지하려면 저장을 선택합니다.

API를 사용하여 로그를 해제하려면

  • conversationLogs 필드 없이 PutBotAlias 작업을 호출합니다.

API를 사용하여 텍스트 로그를 해제하려면

    • 오디오를 로깅하는 경우

      • AUDIO에 대한 logSettings 항목만 사용하여 PutBotAlias 작업을 호출합니다.

      • PutBotAlias 작업 호출에는 TEXT에 대한 logSettings 항목이 없어야 합니다.

    • 오디오를 로깅하지 않는 경우

      • conversationLogs 필드 없이 PutBotAlias 작업을 호출합니다.

API를 사용하여 오디오 로그를 해제하려면

    • 텍스트를 로깅하는 경우

      • TEXT에 대한 logSettings항목만 사용하여 PutBotAlias 작업을 호출합니다.

      • PutBotAlias 작업 호출에는 AUDIO에 대한 logSettings 항목이 없어야 합니다.

    • 텍스트를 로깅하지 않는 경우

      • conversationLogs 필드 없이 PutBotAlias 작업을 호출합니다.