Registro de chat

La función de registro de chat permite registrar todos los mensajes de una sala en cualquiera de las tres ubicaciones estándar: un bucket de Amazon S3, Registros de Amazon CloudWatch o Amazon Kinesis Data Firehose. Luego, puede utilizar los registros para analizarlos o crear una repetición del chat que se vincule a una sesión de video en directo.

Habilitar el registro de chat para una sala

El registro de chat es una opción avanzada que se puede habilitar mediante la vinculación de una configuración de registro con una sala. La configuración de registro es un recurso que permite especificar el tipo de ubicación (el bucket de Amazon S3, los registros de Amazon CloudWatch o Amazon Kinesis Data Firehose) en la que se registran los mensajes de una sala. Para obtener más información sobre la creación y la administración de las configuraciones de registro, consulte la Introducción al chat de Amazon IVS y la Referencia de la API de chat de Amazon IVS.

Puede asociar hasta tres configuraciones de registro a cada sala, ya sea cuando crea una nueva (CreateRoom) o cuando actualiza una actual (UpdateRoom). Puede asociar varias salas con la misma configuración de registro.

Cuando se asocia al menos una configuración de registro activa a una sala, todas las solicitudes de mensajería enviadas a esa sala a través de la API de mensajería de chat de Amazon IVS se graban automáticamente en las ubicaciones especificadas. Estos son los retrasos de propagación promedio (desde que se envía una solicitud de mensaje hasta que está disponible en las ubicaciones especificadas):

• Bucket de Amazon S3: 5 minutos

• Registros de Amazon CloudWatch o Amazon Kinesis Data Firehose: 10 segundos

Contenido del mensaje

Formato

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

Campos

Campo	Descripción
event_timestamp	Marca de tiempo UTC de cuando el chat de Amazon IVS recibió el mensaje.
payload	La carga JSON de Mensaje (suscripción) o Evento (suscripción) que los clientes recibirán del servicio de chat de Amazon IVS.
type	Tipo de mensaje de chat. Valores válidos: MESSAGE | EVENT
version	Versión del formato del contenido del mensaje.

Bucket de Amazon S3

Formato

Los registros de mensajes se organizan y almacenan con el siguiente prefijo S3 y formato de archivo:

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

Campos

Campo	Descripción
<account_id>	ID de la cuenta de AWS a partir de la que se creó la sala.
<hash>	Un valor de hash que genera el sistema para garantizar la unicidad.
<region>	La región del servicio de AWS en la que se creó la sala.
<resource_id>	La parte de identificación del recurso del ARN de la sala.
<version>	Versión del formato del contenido del mensaje.
<year> / <month> / <day> / <hours> / <minute>	Marca de tiempo UTC de cuando el chat de Amazon IVS recibió el mensaje.

Ejemplo

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

Registros de Amazon CloudWatch

Formato

Los registros de mensajes se organizan y almacenan con el siguiente formato de nombre de flujo de registro:

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

Campos

Campo	Descripción
<resource_id>	Parte de identificación del recurso del ARN de la sala.
<version>	Versión del formato del contenido del mensaje.

Ejemplo

aws/IVSChatLogs/1.0/room_abc123DEF456

Amazon Kinesis Data Firehose

Los registros de mensajes se envían al flujo de entrega como datos de transmisión en tiempo real a destinos como Amazon Redshift, Amazon OpenSearch Service, Splunk y cualquier punto de conexión HTTP personalizado o que sea de proveedores de servicios de terceros compatibles. Para obtener más información, consulte ¿Qué es Amazon Kinesis Data Firehose?.

Restricciones

• Debe ser el propietario de la ubicación de registro en la que se almacenarán los mensajes.

• La sala, la configuración del registro y su ubicación deben estar en la misma región de AWS.

• Solo las configuraciones de registro activas están disponibles para el registro de chat.

• Solo puede eliminar una configuración de registro que ya no esté asociada a ningún canal.

El registro de mensajes en una ubicación de su propiedad requiere autorización con sus credenciales de AWS. Para otorgarle al chat de IVS el acceso necesario, se genera automáticamente una política de recursos (para un bucket de Amazon S3 o los registros de CloudWatch) o un rol vinculado a servicios (SLR) de AWS IAM (para Amazon Kinesis Data Firehose) cuando se crea la configuración de registro. Tenga cuidado con las modificaciones del rol o las políticas, ya que eso puede afectar el permiso de registro del chat.

Monitoreo de errores con Amazon CloudWatch

Puede monitorear los errores que se producen en el registro del chat con Amazon CloudWatch y crear alarmas o paneles de mando para indicar o responder a los cambios de errores específicos.

Existen varios tipos de errores. Para obtener más información, consulte Supervisión de Chat de Amazon IVS.