配置对话日志 - 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 Logs 日志组的更多信息，请参阅《Amazon CloudWatch Logs 用户指南》中的使用日志组和日志流。

要存储音频日志，请使用 AWS 账户中 Amazon S3 存储桶。您可以使用任何有效的 S3 存储桶。该存储桶必须与 Amazon Lex 存储桶位于同一区域。有关创建 S3 存储桶的更多信息，请参阅《Amazon Simple Storage Service 用户指南》中的创建存储桶。

您必须为 IAM 角色提供策略，使 Amazon Lex 能够写入配置的日志组或存储桶。有关更多信息，请参阅为对话日志创建 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/lex，打开 Amazon Lex 控制台。

  2. 从列表中，选择一个自动程序。

  3. 选择 Settings (设置) 选项卡，然后从左侧菜单中选择 Conversation logs (对话日志)。

  4. 在别名列表中，选择要配置对话日志的别名的设置图标。

  5. 选择是记录文本、音频还是两者。

  6. 对于文本日志，输入 Amazon CloudWatch Logs 日志组名称。

  7. 对于音频日志记录，请输入 S3 存储桶信息。

  8. 可选。如需加密音频日志，请选择用于加密的 AWS KMS 密钥。

  9. 选择具有所需权限的 IAM 角色。

  10. 选择 Save (保存) 以开始记录对话。

使用 API 启用文本日志

  1. 使用 conversationLogs 字段中 logSettings 成员的条目调用 PutBotAlias 操作

    • 将 destination 成员设置为 CLOUDWATCH_LOGS

    • 将 logType 成员设置为 TEXT

    • 将 resourceArn 成员设置为用于存储日志的 CloudWatch Logs 日志组的 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. 选择 Settings (设置) 选项卡，然后从左侧菜单中选择 Conversation logs (对话日志)。

  4. 在别名列表中，选择要配置对话日志的别名的设置图标。

  5. 清除文本日志和/或音频日志的复选框以禁用日志记录。

  6. 选择 Save (保存) 以停止记录对话。

使用 API 禁用日志

  • 不带 conversationLogs 字段调用 PutBotAlias 操作。

使用 API 禁用文本日志

    • 正在记录音频时

      • 仅对于 AUDIO，使用 logSettings 条目调用 PutBotAlias 操作。

      • 对 PutBotAlias 操作的调用不得包括针对 TEXT 的条目 logSettings。

    • 没有记录音频时

      • 不带 conversationLogs 字段调用 PutBotAlias 操作。

使用 API 禁用音频日志

    • 正在记录文本时

      • 仅对于 TEXT，使用 logSettings 条目调用 PutBotAlias 操作。

      • 对 PutBotAlias 操作的调用不得包括针对 AUDIO 的条目 logSettings。

    • 没有记录文本时

      • 不带 conversationLogs 字段调用 PutBotAlias 操作。