

Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration des journaux de conversation
<a name="conversation-logs-configure"></a>

Vous activez et désactivez les journaux de conversation à l'aide de la console ou du champ `conversationLogs` de l'opération `PutBotAlias`. Vous pouvez activer ou désactiver les journaux audio, les journaux de texte ou les deux. La journalisation démarre sur les nouvelles sessions de bot. Les modifications apportées aux paramètres du journal ne sont pas prises en compte pour les sessions actives.

Pour stocker des journaux de texte, utilisez un groupe de CloudWatch journaux Amazon Logs dans votre AWS compte. Vous pouvez utiliser n'importe quel groupe de journaux valide. Le groupe de journaux doit se trouver dans la même région que le bot Amazon Lex. Pour plus d'informations sur la création d'un groupe de CloudWatch journaux, consultez la section [Working with Log Groups and Log Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) dans le *guide de l'utilisateur Amazon CloudWatch Logs*.

Pour stocker des journaux audio, utilisez un compartiment Amazon S3 dans votre AWS compte. Vous pouvez utiliser n'importe quel compartiment S3 valide. Le compartiment doit se trouver dans la même région que le bot Amazon Lex. Pour plus d'informations sur la création d'un compartiment S3, consultez la section [Créer un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) dans le *guide de démarrage Amazon Simple Storage Service*.

Vous devez fournir un rôle IAM avec des politiques qui permettent à Amazon Lex d'écrire dans le groupe de journaux ou le compartiment configuré. Pour de plus amples informations, veuillez consulter [Création d'un rôle IAM et de stratégies pour les journaux de conversation](conversation-logs-policies.md#conversation-logs-role-and-policy).

Si vous créez un rôle lié à un service à l'aide du AWS Command Line Interface, vous devez ajouter un suffixe personnalisé au rôle à l'aide de l'`custom-suffix`option suivante :

```
aws iam create-service-linked-role \
    --aws-service-name lex.amazon.aws.com \
    --custom-suffix suffix
```

Le rôle IAM que vous utilisez pour activer les journaux de conversation doit disposer de cette `iam:PassRole` autorisation. La stratégie suivante doit être attachée au rôle.

------
#### [ JSON ]

****  

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

------

## Activation des journaux de conversation
<a name="conversation-logs-enable"></a>

**Pour activer les journaux à l'aide de la console**

1. Ouvrez la console Amazon Lex [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).

1. Dans la liste, choisissez un bot.

1. Choisissez l'onglet **Settings (Paramètres)** puis dans le menu de gauche, choisissez **Conversation logs (Journaux de conversation)**.

1. Dans la liste des alias, choisissez l'icône des paramètres de l'alias pour lequel vous souhaitez configurer les journaux de conversation.

1. Indiquez si vous souhaitez consigner du texte, de l’audio ou les deux. 

1. Pour l'enregistrement de texte, entrez le nom du groupe de CloudWatch journaux Amazon Logs.

1. Pour la journalisation de données audio, entrez les informations du compartiment S3.

1. Facultatif. Pour chiffrer les journaux audio, choisissez la AWS KMS clé à utiliser pour le chiffrement.

1. Choisissez un rôle IAM doté des autorisations requises.

1. Choisissez **Save (Enregistrer)** pour démarrer la journalisation des conversations.

**Pour activer les journaux de texte à l'aide de l'API**

1. Appelez l'opération [PutBotAlias](API_PutBotAlias.md) avec une entrée dans le membre `logSettings` du champ `conversationLogs`.
   + Définissez le membre `destination` sur `CLOUDWATCH_LOGS`
   + Définissez le membre `logType` sur `TEXT`
   + Définissez le `resourceArn` membre sur l'Amazon Resource Name (ARN) du groupe de CloudWatch journaux Logs qui est la destination des journaux

1. Définissez le `iamRoleArn` membre du `conversationLogs` champ sur le nom de ressource Amazon (ARN) d'un rôle IAM disposant des autorisations requises pour activer les journaux de conversation sur les ressources spécifiées.

**Pour activer les journaux audio à l'aide de l'API**

1. Appelez l'opération [PutBotAlias](API_PutBotAlias.md) avec une entrée dans le membre `logSettings` du champ `conversationLogs`.
   + Définissez le membre `destination` sur `S3`
   + Définissez le membre `logType` sur `AUDIO`
   + Définissez le membre `resourceArn` sur l'ARN du compartiment Amazon S3 où les journaux audio sont stockés.
   + Facultatif. Pour chiffrer les journaux audio avec une AWS KMS clé spécifique, définissez le `kmsKeyArn` membre de l'ARN de la clé utilisée pour le chiffrement.

1. Définissez le `iamRoleArn` membre du `conversationLogs` champ sur le nom de ressource Amazon (ARN) d'un rôle IAM disposant des autorisations requises pour activer les journaux de conversation sur les ressources spécifiées.

## Désactivation des journaux de conversation
<a name="conversation-logs-disable"></a>

**Pour désactiver les journaux à l'aide de la console**

1. Ouvrez la console Amazon Lex [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).

1. Dans la liste, choisissez un bot.

1. Choisissez l'onglet **Settings (Paramètres)** puis dans le menu de gauche, choisissez **Conversation logs (Journaux de conversation)**.

1. Dans la liste des alias, choisissez l'icône des paramètres de l'alias pour lequel vous souhaitez configurer les journaux de conversation.

1. Désactivez la vérification du texte, de l'audio ou des deux pour désactiver la journalisation.

1. Choisissez **Save (Enregistrer)** pour arrêter la journalisation des conversations.

**Pour désactiver les journaux à l'aide de l'API**
+ Appelez l'opération `PutBotAlias` sans le champ `conversationLogs`.

**Pour désactiver les journaux de texte à l'aide de l'API**
+ 
  + Si vous journalisez les données audio
    + Appelez l'opération [PutBotAlias](API_PutBotAlias.md) avec une entrée `logSettings` uniquement pour `AUDIO`.
    + L'appel à l'opération `PutBotAlias` ne doit pas avoir d'entrée `logSettings` pour `TEXT`.
  + Si vous ne journalisez pas les données audio
    + Appelez l'opération [PutBotAlias](API_PutBotAlias.md) sans le champ `conversationLogs`.

**Pour désactiver les journaux des données audio à l'aide de l'API**
+ 
  + Si vous journalisez du texte
    + Appelez l'opération [PutBotAlias](API_PutBotAlias.md) avec une entrée `logSettings` uniquement pour `TEXT`.
    + L'appel à l'opération `PutBotAlias` ne doit pas avoir d'entrée `logSettings` pour `AUDIO`.
  + Si vous ne journalisez pas de texte
    + Appelez l'opération [PutBotAlias](API_PutBotAlias.md) sans le champ `conversationLogs`.