终止支持通知：2025年9月15日， AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后，您将无法再访问 Amazon Lex V1 控制台或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2，请改为参阅 [Amazon Lex V2 指南](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 配置对话日志
您可以使用控制台或 `PutBotAlias` 操作的 `conversationLogs` 字段来启用和禁用对话日志。您可以启用或禁用音频日志和/或文本日志。日志记录将在新自动程序会话上启动。对日志设置的更改不会体现在活动会话中。
要存储文本日志，请在您的 AWS 账户中使用一个 Amazon Log CloudWatch s 日志组。您可以使用任何有效的日志组。日志组必须与 Amazon Lex 机器人位于同一区域中。有关创建 CloudWatch 日志组的更多信息，请参阅 *Amazon Logs 用户指南中的使用日志组和 CloudWatch 日志*[流](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。
要存储音频日志，请在您的 AWS 账户中使用 Amazon S3 存储桶。您可以使用任何有效的 S3 存储桶。该存储桶必须与 Amazon Lex 存储桶位于同一区域。有关创建 S3 存储桶的更多信息，请参阅《Amazon Simple Storage Service 用户指南》**中的[创建存储桶](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html)。
您必须为 IAM 角色提供策略，使 Amazon Lex 能够写入配置的日志组或存储桶。有关更多信息，请参阅 [为对话日志创建 IAM 角色和策略](conversation-logs-policies.md#conversation-logs-role-and-policy)。
如果您使用创建服务相关角色 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` 权限。应将以下策略附加到角色。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## 启用对话日志
**使用控制台启用日志**
1. 打开 Amazon Lex 控制台 [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex)。
1. 从列表中，选择一个机器人。
1. 选择 **Settings (设置)** 选项卡，然后从左侧菜单中选择 **Conversation logs (对话日志)**。
1. 在别名列表中，选择要配置对话日志的别名的设置图标。
1. 选择是记录文本、音频还是两者。
1. 要进行文本记录，请输入 Amazon Log CloudWatch s 日志组名称。
1. 对于音频日志记录，请输入 S3 存储桶信息。
1. 可选。要加密音频日志，请选择用于加密的密 AWS KMS 钥。
1. 选择具有所需权限的 IAM 角色。
1. 选择 **Save（保存）**以开始记录对话。
**使用 API 启用文本日志**
1. 使用 `conversationLogs` 字段中 `logSettings` 成员的条目调用 [PutBotAlias](API_PutBotAlias.md) 操作
+ 将 `destination` 成员设置为 `CLOUDWATCH_LOGS`
+ 将 `logType` 成员设置为 `TEXT`
+ 将`resourceArn`成员设置为日志日志组的 Amazon 资源名称 (ARN)，该组是 CloudWatch 日志的目标
1. 将 `conversationLogs` 字段的 `iamRoleArn` 成员设置为 IAM 角色的 Amazon 资源名称 (ARN)，该角色应具有在指定资源上启用对话日志所需的权限。
**使用 API 启用音频日志**
1. 使用 `conversationLogs` 字段中 `logSettings` 成员的条目调用 [PutBotAlias](API_PutBotAlias.md) 操作
+ 将 `destination` 成员设置为 `S3`
+ 将 `logType` 成员设置为 `AUDIO`
+ 将 `resourceArn` 成员设置为存储音频日志的 Amazon S3 存储桶的 ARN
+ 可选。要使用特定 AWS KMS 密钥加密音频日志，请设置用于加密的密钥的 ARN `kmsKeyArn` 成员。
1. 将 `conversationLogs` 字段的 `iamRoleArn` 成员设置为 IAM 角色的 Amazon 资源名称 (ARN)，该角色应具有在指定资源上启用对话日志所需的权限。
## 禁用对话日志
**使用控制台禁用日志**
1. 打开 Amazon Lex 控制台 [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex)。
1. 从列表中，选择一个机器人。
1. 选择 **Settings (设置)** 选项卡，然后从左侧菜单中选择 **Conversation logs (对话日志)**。
1. 在别名列表中，选择要配置对话日志的别名的设置图标。
1. 清除文本日志和/或音频日志的复选框以禁用日志记录。
1. 选择 **Save（保存）**以停止记录对话。
**使用 API 禁用日志**
+ 不带 `conversationLogs` 字段调用 `PutBotAlias` 操作。
**使用 API 禁用文本日志**
+
+ 正在记录音频时
+ 仅对于 `AUDIO`，使用 `logSettings` 条目调用 [PutBotAlias](API_PutBotAlias.md) 操作。
+ 对 `PutBotAlias` 操作的调用不得包括针对 `TEXT` 的条目 `logSettings`。
+ 没有记录音频时
+ 不带 `conversationLogs` 字段调用 [PutBotAlias](API_PutBotAlias.md) 操作。
**使用 API 禁用音频日志**
+
+ 正在记录文本时
+ 仅对于 `TEXT`，使用 `logSettings` 条目调用 [PutBotAlias](API_PutBotAlias.md) 操作。
+ 对 `PutBotAlias` 操作的调用不得包括针对 `AUDIO` 的条目 `logSettings`。
+ 没有记录文本时
+ 不带 `conversationLogs` 字段调用 [PutBotAlias](API_PutBotAlias.md) 操作。