Konversationsprotokolle konfigurieren

Sie aktivieren und deaktivieren Konversationsprotokolle über die Konsole oder das conversationLogSettings Feld der UpdateBotAlias Operation CreateBotAlias oder. 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 V2-Bot befinden. Weitere Informationen zum Erstellen einer CloudWatch Logs-Protokollgruppe finden Sie unter Working with Log Groups and Log Streams 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 V2-Bot befinden. Weitere Informationen zum Erstellen eines S3-Buckets finden Sie unter Erstellen eines Buckets im Amazon Simple Storage Service Getting Started Guide.

Wenn Sie Konversationsprotokolle mit der Konsole verwalten, aktualisiert die Konsole Ihre Servicerolle, sodass sie Zugriff auf die Protokollgruppe und den S3-Bucket hat.

Wenn Sie die Konsole nicht verwenden, müssen Sie eine IAM-Rolle mit Richtlinien bereitstellen, die es Amazon Lex V2 ermöglichen, in die konfigurierte Protokollgruppe oder den konfigurierten Bucket zu schreiben. Wenn Sie mit dem eine serviceverknüpfte Rolle erstellen AWS Command Line Interface, müssen Sie der Rolle mithilfe der custom-suffix Option ein benutzerdefiniertes Suffix hinzufügen, wie im folgenden Beispiel gezeigt. Weitere Informationen finden Sie unter Erstellen einer IAM-Rolle und von Richtlinien für Konversationsprotokolle.

aws iam create-service-linked-role \
    --aws-service-name lexv2.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 der Rolle beigefügt werden:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::account:role/role"
        }
    ]
}  

Konversationsprotokolle aktivieren

So aktivieren Sie Protokolle über die Konsole

1. Öffnen Sie die Amazon Lex V2-Konsole https://console.aws.amazon.com/lexv2.

2. Wählen Sie aus der Liste einen Bot aus.

3. Wählen Sie im linken Menü Aliase aus.

4. Wählen Sie in der Aliasliste den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.

5. Wählen Sie im Abschnitt Konversationsprotokolle die Option Konversationsprotokolle verwalten aus.

6. Für Textprotokolle wählen Sie Aktivieren und geben Sie dann den Namen der Amazon CloudWatch Logs-Protokollgruppe ein.

7. Für Audioprotokolle wählen Sie Aktivieren und geben Sie dann die S3-Bucket-Informationen ein.

8. Optional. Um Audioprotokolle zu verschlüsseln, wählen Sie den AWS KMS Schlüssel aus, der für die Verschlüsselung verwendet werden soll.

9. Wählen Sie Save (Speichern), um Konversationen zu protokollieren. Falls erforderlich, aktualisiert Amazon Lex V2 Ihre Servicerolle mit Berechtigungen für den Zugriff auf die CloudWatch Logs-Protokollgruppe und den ausgewählten S3-Bucket.

Konversationsprotokolle deaktivieren

So deaktivieren Sie Protokolle über die Konsole

1. Öffnen Sie die Amazon Lex V2-Konsole https://console.aws.amazon.com/lexv2.

2. Wählen Sie aus der Liste einen Bot aus.

3. Wählen Sie im linken Menü Aliase aus.

4. Wählen Sie in der Aliasliste den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.

5. Wählen Sie im Abschnitt Konversationsprotokolle die Option Konversationsprotokolle verwalten aus.

6. Deaktivieren Sie die Textprotokollierung, die Audioprotokollierung oder beides, um die Protokollierung zu deaktivieren.

7. Wählen Sie Save (Speichern), um die Protokollierung von Konversationen zu beenden.