本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 管理选择性对话日志捕获
<a name="manage-selective-logging"></a>

使用 Lex 控制台，您可以启用选择性对话日志捕获设置，并选择要为哪些槽位启用选择性对话日志捕获功能。

**在 Amazon Lex V2 控制台中激活选择性对话日志捕获：**

1. 登录 AWS 管理控制台并在[https://console.aws.amazon.com/lexv2/家](https://console.aws.amazon.com/lexv2/home)中打开 Amazon Lex V2 控制台。

1. 从左侧面板中选择**机器人**，然后选择要启用选择性对话日志捕获的机器人。选择一个现有机器人，或创建一个新的机器人。

1. 在左侧面板的**部署**部分下为所选机器人选择**别名**。

1. 选择你的机器人的别名，然后选择**管理对话日志**。

1. 在**管理对话日志**面板中，对于**文本日志**，点击单选按钮以选择是启用还是禁用文本日志。如果选择**启用**文本日志，则需要输入**日志组名称**或从下拉菜单中选择现有的日志组名称。如果您选择性地对文本文件进行日志记录，请选中**选择性地对言语进行日志记录**复选框。
**注意**  
通过在构建**时间设置中的对话日志设置（文本 and/or 音频）中选中选择性****记录话语复选框来启用文本 and/or 音频日志**。**BotAlias**您必须配置 CloudWatch 日志组和 Amazon S3 存储桶才能选择此选项。

1. 在**音频日志**部分中，点击单选按钮以选择是启用还是禁用音频日志。如果您选择**启用**音频日志，则需要指定 Amazon S3 存储桶位置以及（可选）用于加密音频数据的 KMS 密钥。如果您选择性地对音频文件进行日志记录，请选中**选择性地对言语进行日志记录**复选框。  
![\[用于管理对话日志的面板。\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/images/logging/selective-manage-logs.png)

1. 选择面板右下角的**保存**以保存您的选择性对话日志捕获设置。

**在 Amazon Lex V2 控制台中激活选择性对话日志捕获：**

1. 转到**意图**，选择**意图名称**、**初始响应**、**高级设置**、**设置值**、**会话属性**。

1. 根据要为其启用选择性对话日志捕获的意图和槽位，完成以下属性设置：
   + `x-amz-lex:enable-audio-logging:intent:slot = "true"`
   + `x-amz-lex:enable-text-logging:intent:slot = "true"`  
![\[用于添加选择性会话属性的面板。\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/images/logging/selective-session-attributes.png)
**注意**  
设置 `x-amz-lex:enable-audio-logging:intent:slot = "true"` 以捕获对话中仅包含特定槽位的言语。记录话语的操作取决于对以下内容的评估*intent *：*slot*在话语中、与会话属性表达式的比较以及相应的标志值。要对言语进行日志记录，会话属性中必须有至少一个表达式允许该日志记录操作，并且启用日志记录标志需要设置为 `true`。*intent*和的值*slot*也可以`"*"`是。如果插槽 and/or 意图值为`"*"`，则表示任何插槽 and/or 意图值都`"*"`将与其匹配。与 `x-amz-lex:enable-audio-logging` 类似，名为 `x-amz-lex:enable-text-logging` 的新会话属性将用于控制文本日志。

1. 选择**更新选项**，然后构建机器人以包含更新的设置。

**注意**  
您的 IAM 角色必须具有访问权限，才能允许您向 Amazon S3 存储桶写入数据并使用 KMS 密钥加密数据。Lex 将更新您的 IAM 角色，使其具有 Lex 访问 CloudWatch 日志组和选定的 Amazon S3 存储桶的权限。

**选择性对话日志捕获的使用指南：**

只有在对话日志**设置中启用了文本 and/or 音频日志后，才能为文本 and/or 音频日志启用选择性对话日志**捕获。通过为文本 and/or 音频日志启用选择性对话日志捕获，可以禁用对话中所有意图和时段的日志记录。要为特定意图和插槽生成文本 and/or 音频日志，必须将这些意图和插槽的文本 or/and 音频选择性对话日志捕获会话属性设置为 “true”。
+ 如果启用了选择性对话日志捕获，并且不存在带前缀 x-amz-lex:的会话属性，enable-audio-logging 则默认情况下，所有话语的日志记录都将处于禁用状态。这种情况在 x-amz-lex以下方面也是如此:enable-text-logging.
+ 如果会话属性中至少有一个表达式允许，则将专门存储文本 and/or 音频对话片段的话语日志。
+ 只有在机器人别名的 “对话日志设置” 中启用文本 and/or 音频的选择性对话日志捕获时，会话属性中定义的文本 and/or 音频选择性对话日志捕获配置才会生效；否则，会话属性将被忽略。
+ 启用选择性对话日志捕获后，“解释” 和 “转录” 中 SessionState未使用会话属性启用日志记录的任何时隙值都将在生成的文本日志中进行模糊处理。
+ 生成音频 and/or 文本日志的决定是通过将机器人引发的时段与选择性对话日志捕获会话属性进行匹配来评估的，但意图诱发回合除外，在该回合中，用户可以提供插槽值以及意图引发。在意图引发回合中，将当前回合中被填充的槽位与选择性对话日志捕获会话属性进行匹配 
+ 被认为已填充的槽位来自回合结束时的会话状态。因此，Dialog Codehook Lambda 对处于会话状态的槽位所做的任何更改都将影响选择性对话日志捕获的行为。
+ 在意图诱发回合中，如果用户给出了多个插槽值，则只有当会 text/audio 话属性允许记录该回合中填充的所有插槽时，才会生成文本 and/or 音频日志。
+ 推荐的操作方法是在会话开始时设置选择性对话日志捕获会话属性，并且避免在会话期间对其进行修改。
+ 如果任何槽位包含敏感数据，则应始终启用槽位模糊处理。