Journalisation du Chat IVS - Amazon IVS
Activer la journalisation des chats pour une salleContenu des messagesCompartiment Amazon S3Amazon CloudWatch LogsAmazon Kinesis Data FirehoseConstraintsSurveillance des erreurs avec Amazon CloudWatch

Journalisation du Chat IVS

La fonctionnalité de journalisation des chats vous permet d'enregistrer tous les messages d'une salle vers l'un des trois emplacements standard : un compartiment Amazon S3, Amazon CloudWatch Logs ou Amazon Kinesis Data Firehose. Par la suite, les journaux peuvent être utilisés à des fins d'analyse ou pour créer une rediffusion du chat en lien avec une session vidéo en direct.

Activer la journalisation des chats pour une salle

La journalisation des chats est une option avancée qui peut être activée en associant une configuration de journalisation à une salle. Une configuration de journalisation est une ressource qui vous permet de spécifier un type d'emplacement (compartiment Amazon S3, Amazon CloudWatch Logs ou Amazon Kinesis Data Firehose) où les messages d'une salle sont journalisés. Pour plus de détails sur la création et la gestion des configurations de journalisation, consultez les sections Mise en route avec Amazon IVS Chat et Référence de l'API Amazon IVS Chat (langue française non garantie).

Vous pouvez associer jusqu'à trois configurations de journalisation à chaque salle, soit lors de la création d'une salle (CreateRoom), soit lors de la mise à jour d'une salle existante (UpdateRoom). Vous pouvez associer plusieurs salles à la même configuration de journalisation.

Lorsqu'au moins une configuration de journalisation active est associée à une salle, chaque demande de messagerie envoyée à cette salle via l'API de messagerie Amazon IVS Chat (langue française non garantie) est automatiquement enregistrée dans le ou les emplacements spécifiés. Voici les délais de propagation moyens (entre le moment où une demande de messagerie est envoyée et le moment où elle devient disponible dans les emplacements que vous avez spécifiés) :

  • Compartiment Amazon S3 : 5 minutes

  • Amazon CloudWatch Logs ou Amazon Kinesis Data Firehose : 10 secondes

Contenu des messages

Format

{
   "event_timestamp": "string",
   "type": "string",
   "version": "string",
   "payload": { "string": "string" }
}

Champs

Champ Description

event_timestamp

Horodatage UTC indiquant la date à laquelle le message a été reçu par Amazon IVS Chat.

payload

La charge utile JSON de Message (Subscribe) [Message (S'abonner)] ou d'Event (Subscribe) [Événement (S'abonner)] que les clients recevront du service Amazon IVS Chat.

type

Type du message de chat.

  • Valeurs valides : MESSAGE | EVENT

version

Version du format de contenu du message.

Compartiment Amazon S3

Format

Les journaux de messages sont organisés et stockés avec le préfixe S3 et le format de fichier suivants :

AWSLogs/<account_id>/IVSChatLogs/<version>/<region>/room_<resource_id>/<year>/<month>/<day>/<hours>/<account_id>_IVSChatLogs_<version>_<region>_room_<resource_id>_<year><month><day><hours><minutes>_<hash>.log.gz

Champs

Champ Description

<account_id>

ID de compte AWS à partir duquel la salle est créée.

<hash>

Valeur de hachage générée par le système pour garantir l'unicité.

<region>

Région de service AWS dans laquelle la salle a été créée.

<resource_id>

La partie de l'ID de la ressource de l'ARN de la salle.

<version>

 Version du format de contenu du message.

<year> / <month> / <day> / <hours> / <minute>

Horodatage UTC indiquant la date à laquelle le message a été reçu par Amazon IVS Chat.

Exemple

AWSLogs/123456789012/IVSChatLogs/1.0/us-west-2/room_abc123DEF456/2022/10/14/17/123456789012_IVSChatLogs_1.0_us-west-2_room_abc123DEF456_20221014T1740Z_1766dcbc.log.gz

Amazon CloudWatch Logs

Format

Les journaux de messages sont organisés et stockés selon le format de nom de flux de journaux suivant :

aws/IVSChatLogs/<version>/room_<resource_id>

Champs

Champ Description

<resource_id>

Partie de l'ID de la ressource de l'ARN de la salle.

<version>

Version du format de contenu du message.

Exemple

aws/IVSChatLogs/1.0/room_abc123DEF456

Amazon Kinesis Data Firehose

Les journaux de messages sont envoyés au flux de diffusion sous forme de données de streaming en temps réel vers des destinations telles qu'Amazon Redshift, Amazon OpenSearch Service, Splunk, et tout point de terminaison HTTP personnalisé ou appartenant à des fournisseurs de services tiers pris en charge. Pour plus d'informations, consultez Qu'est-ce qu'Amazon Kinesis Data Firehose.

Constraints

  • Vous devez être propriétaire de l'emplacement de journalisation où les messages seront stockés.

  • La salle, la configuration de journalisation et l'emplacement de journalisation doivent se situer dans la même région AWS.

  • Seules les configurations de journalisation actives sont disponibles pour la journalisation des chats.

  • Vous ne pouvez supprimer une configuration de journalisation que si elle n'est plus associée à aucune salle.

La journalisation de messages dans un emplacement qui vous appartient nécessite une autorisation avec vos informations d'identification AWS. Pour accorder à IVS Chat l'accès requis, une politique de ressources (pour un compartiment Amazon S3 ou CloudWatch Logs) ou un rôle AWS IAM lié à un service (SLR) (pour Amazon Kinesis Data Firehose) est automatiquement généré lors de la création de la configuration de journalisation. Soyez prudent quant à toute modification du rôle ou des politiques, car cela peut avoir un impact sur l'autorisation de journalisation du chat.

Surveillance des erreurs avec Amazon CloudWatch

Vous pouvez surveiller les erreurs survenant dans la journalisation du chat avec Amazon CloudWatch, et vous pouvez créer des alarmes ou des tableaux de bord pour indiquer les changements d'erreurs spécifiques ou y répondre.

Il existe plusieurs types d'erreurs. Pour plus d'informations, consultez Surveillance de Chat Amazon IVS.