サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 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 CloudWatch Logs ロググループを使用します。任意の有効なロググループを使用できます。ロググループは、Amazon Lex ボットと同じリージョンに存在する必要があります。CloudWatch Logs ロググループの詳細については、*「Amazon CloudWatch Logs User Guide」*(Amazon CloudWatch Logs ユーザーガイド) の[「Working with Log Groups and Log Streams」](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 Getting Started Guide」*(Amazon Simple Storage Service 入門ガイド) の[「Create a Bucket」](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html)(バケットの作成) を参照してください。
設定済みのロググループまたはバケットへの Amazon Lex による書き込みを有効にするポリシーのある IAM ロールを指定する必要があります。詳細については、「[会話ログ用の 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 CloudWatch Logs のロググループ名を入力します。
1. オーディオのログ記録の場合は、S3 バケット情報を入力します。
1. オプション。オーディオログを暗号化するには、暗号化に使用する AWS KMS キーを選択します。
1. 必要な権限を持つ IAM ロールを選択します。
1. **[Save]** (保存) を選択して、会話のログ記録を開始します。
**API を使用してテキストログを有効にするには**
1. `conversationLogs` フィールドの `logSettings` メンバーのエントリを使用して [PutBotAlias](API_PutBotAlias.md) オペレーションを呼び出す
+ `destination` メンバーを `CLOUDWATCH_LOGS` に設定する
+ `logType` メンバーを `TEXT` に設定する
+ ログの送信先である CloudWatch Logs ロググループの Amazon リソースネーム (ARN) に `resourceArn` メンバーを設定する
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) オペレーションを呼び出します。