Hinweis zum Ende des Supports: Am 15. September 2025 AWS wird der Support für Amazon Lex V1 eingestellt. Nach dem 15. September 2025 können Sie nicht mehr auf die Amazon-Lex-V1-Konsole oder die Amazon-Lex-V1-Ressourcen zugreifen. Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das [Amazon Lex V2-Handbuch](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Konfigurieren von Konversationsprotokollen
Sie aktivieren und deaktivieren Konversationsprotokolle über die Konsole oder das `conversationLogs`-Feld der `PutBotAlias`-Operation. Sie können Audioprotokolle, Textprotokolle oder beides aktivieren oder deaktivieren. Die Protokollierung beginnt bei neuen Botsitzungen. Änderungen an den Protokolleinstellungen werden für aktive Sitzungen nicht berücksichtigt.
Um Textprotokolle zu speichern, verwenden Sie eine Amazon CloudWatch Logs-Protokollgruppe in Ihrem AWS Konto. Sie können jede gültige Protokollgruppe verwenden. Die Protokollgruppe muss sich in derselben Region wie der Amazon Lex Lex-Bot befinden. Weitere Informationen zum Erstellen einer CloudWatch Logs-Protokollgruppe finden Sie unter [Working with Log Groups and Log Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
Verwenden Sie zum Speichern von Audioprotokollen einen Amazon S3 S3-Bucket in Ihrem AWS Konto. Sie können jeden gültigen S3-Bucket verwenden. Der Bucket muss sich in derselben Region wie der Amazon Lex Lex-Bot befinden. Weitere Informationen zum Erstellen eines S3-Buckets finden Sie unter [Create a Bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) im *Amazon Simple Storage Service Getting Started Guide*.
Sie müssen eine IAM-Rolle mit Richtlinien bereitstellen, die es Amazon Lex ermöglichen, in die konfigurierte Protokollgruppe oder den konfigurierten Bucket zu schreiben. Weitere Informationen finden Sie unter [Erstellen einer IAM-Rolle und von Richtlinien für Konversationsprotokolle](conversation-logs-policies.md#conversation-logs-role-and-policy).
Wenn Sie mit dem eine serviceverknüpfte Rolle erstellen AWS Command Line Interface, müssen Sie der Rolle ein benutzerdefiniertes Suffix hinzufügen, indem Sie die folgende `custom-suffix` Option verwenden:
```
aws iam create-service-linked-role \
--aws-service-name lex.amazon.aws.com \
--custom-suffix suffix
```
Die IAM-Rolle, die Sie zum Aktivieren von Konversationsprotokollen verwenden, muss über die entsprechende Berechtigung verfügen. `iam:PassRole` Die folgende Richtlinie sollte an die Rolle angefügt werden.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## Aktivieren von Konversationsprotokollen
**So aktivieren Sie Protokolle über die Konsole**
1. Öffnen Sie die Amazon Lex Lex-Konsole [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).
1. Wählen Sie aus der Liste einen Bot aus.
1. Wählen Sie die Registerkarte **Settings (Einstellungen)** und dann im linken Menü **Conversation logs (Konversationsprotokolle)** aus.
1. Wählen Sie in der Liste der Aliasse das Einstellungssymbol für den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.
1. Wählen Sie aus, ob Text, Audio oder beides protokolliert werden soll.
1. Geben Sie für die Textprotokollierung den Namen der Amazon CloudWatch Logs-Protokollgruppe ein.
1. Geben Sie für die Audioprotokollierung die S3-Bucket-Informationen ein.
1. Optional. Um Audioprotokolle zu verschlüsseln, wählen Sie den AWS KMS Schlüssel aus, der für die Verschlüsselung verwendet werden soll.
1. Wählen Sie eine IAM-Rolle mit den erforderlichen Berechtigungen.
1. Wählen Sie **Save (Speichern)**, um Konversationen zu protokollieren.
**So aktivieren Sie Textprotokolle mit der API**
1. Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation mit einem Eintrag im `logSettings`-Element des `conversationLogs`-Feldes auf.
+ Setzen Sie das `destination`-Element auf `CLOUDWATCH_LOGS`.
+ Setzen Sie das `logType`-Element auf `TEXT`.
+ Legen Sie für das `resourceArn` Mitglied den Amazon-Ressourcennamen (ARN) der CloudWatch Logs-Protokollgruppe fest, die das Ziel für die Logs ist
1. Setzen Sie das `iamRoleArn` Mitglied des `conversationLogs` Felds auf den Amazon-Ressourcennamen (ARN) einer IAM-Rolle, die über die erforderlichen Berechtigungen zum Aktivieren von Konversationsprotokollen für die angegebenen Ressourcen verfügt.
**So aktivieren Sie Audioprotokolle mit der API**
1. Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation mit einem Eintrag im `logSettings`-Element des `conversationLogs`-Feldes auf.
+ Setzen Sie das `destination`-Element auf `S3`.
+ Setzen Sie das `logType`-Element auf `AUDIO`.
+ Setzen Sie das `resourceArn`-Element auf den ARN des Amazon S3-Buckets, in dem die Audioprotokolle gespeichert sind.
+ Optional. Um Audioprotokolle mit einem bestimmten AWS KMS Schlüssel zu verschlüsseln, legen Sie das `kmsKeyArn` Mitglied des ARN des Schlüssels fest, der für die Verschlüsselung verwendet wird.
1. Setzen Sie das `iamRoleArn` Mitglied des `conversationLogs` Felds auf den Amazon-Ressourcennamen (ARN) einer IAM-Rolle, die über die erforderlichen Berechtigungen zum Aktivieren von Konversationsprotokollen für die angegebenen Ressourcen verfügt.
## Deaktivieren von Konversationsprotokollen
**So deaktivieren Sie Protokolle über die Konsole**
1. Öffnen Sie die Amazon Lex Lex-Konsole [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).
1. Wählen Sie aus der Liste einen Bot aus.
1. Wählen Sie die Registerkarte **Settings (Einstellungen)** und dann im linken Menü **Conversation logs (Konversationsprotokolle)** aus.
1. Wählen Sie in der Liste der Aliasse das Einstellungssymbol für den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.
1. Entfernen Sie die Markierung bei Text, Audio oder beidem, um die Protokollierung zu deaktivieren.
1. Wählen Sie **Save (Speichern)**, um die Protokollierung von Konversationen zu beenden.
**So deaktivieren Sie Protokolle mit der API**
+ Rufen Sie die `PutBotAlias`-Operation ohne das `conversationLogs`-Feld auf.
**So deaktivieren Sie Textprotokolle mit der API**
+
+ Wenn Sie Audio protokollieren:
+ Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation mit einem `logSettings`-Eintrag nur für `AUDIO` auf.
+ Der Aufruf der `PutBotAlias`-Operation darf keinen `logSettings`-Eintrag für `TEXT` haben.
+ Wenn Sie keine Audiodaten protokollieren
+ Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation ohne das `conversationLogs`-Feld auf.
**So deaktivieren Sie Audioprotokolle mit der API**
+
+ Wenn Sie Text protokollieren
+ Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation mit einem `logSettings`-Eintrag nur für `TEXT` auf.
+ Der Aufruf der `PutBotAlias`-Operation darf keinen `logSettings`-Eintrag für `AUDIO` haben.
+ Wenn Sie keinen Text protokollieren
+ Rufen Sie die [PutBotAlias](API_PutBotAlias.md)-Operation ohne das `conversationLogs`-Feld auf.