Sincronización de registros y observabilidad

El panel de control de Cloud Data Ingesta de Datos (CDI) Sync Log te permite supervisar todos los datos procesados por CDI, verificar si los datos se han sincronizado correctamente y diagnosticar cualquier problema con datos «incorrectos» o faltantes.

Para acceder a los registros de sincronización, ve a Configuración de datos > Ingesta de datos en la nube y selecciona la pestaña Registro de sincronización.

Comprender el panel del registro de sincronización

La página principal del Registro de sincronización ofrece un resumen de alto nivel de todas tus ejecuciones de sincronización, incluido un resumen de las sincronizaciones recientes según su estado actual o final.

• Correr: Sincroniza los trabajos que están actualmente en curso.
• Éxito: Sincronización de tareas completadas y todas las filas procesadas correctamente.
• Éxito parcial: Sincronizar trabajos que se completaron, pero una o más filas encontraron un error.
• Error: Sincronizar trabajos que no se completaron.
• Límite excedido: Sincroniza los trabajos que dejaron de procesarse porque se superó el límite de datos.

Los registros de sincronización también proporcionan los siguientes detalles para cada sincronización:

• Nombre de sincronización: El nombre de la configuración de sincronización.
• ID de ejecución: Identificador único para una ejecución específica de la sincronización. Selecciona este ID para ver más detalles. Esto también se puede utilizar en los puntos finales de la API de CDI o para hacer referencia a una sincronización realizada con el soporte de Braze.
• Estado: El estado de la ejecución (éxito, éxito parcial, error, en ejecución).
• Nuevas filas leídas desde la fuente: El número de filas nuevas extraídas de tu almacén de datos para esta ejecución.
• Resultados: Un desglose del número de filas que han tenido éxito o han fallado durante la ejecución.
• **Último”UPDATED_AT”: ** La marca de tiempo del registro más reciente procesado en esta ejecución de sincronización.
• Hora de inicio de la carrera: Cuándo comenzó la tarea de sincronización.
• Duración de la carrera: El tiempo total que tardó en completarse la tarea de sincronización.

Retención de datos

Los datos del registro de sincronización, incluidas todas las cargas útiles a nivel de fila y los detalles de los errores, se conservan durante un máximo de 30 días. Los registros con más de 30 días de antigüedad se eliminarán automáticamente.

Los metadatos de la ejecución de la sincronización, como el número de filas procesadas, se conservan durante al menos 12 meses.

Filtrado de registros de sincronización

Puedes filtrar la tabla de registros de sincronización para encontrar ejecuciones específicas. Los filtros disponibles incluyen:

• Fecha de inicio del trabajo: Selecciona un intervalo predefinido (como «Últimos 30 días») o un intervalo de fechas personalizado.
• Estado: Filtrar por uno o más estados de sincronización (por ejemplo, mostrar solo los estados Error y Éxito parcial).
• Nombre de sincronización: Busca una sincronización específica por su nombre.

Para investigar una sincronización específica, selecciona el ID de ejecución correspondiente en la tabla Registros de sincronización. En la página de detalles de la ejecución, encontrarás un registro detallado, fila por fila, de la sincronización.

Resumen de la carrera

Esta sección resume la ejecución seleccionada, incluyendo la hora de inicio, la hora de finalización, la duración y el número total de filas leídas desde la fuente. También proporciona un recuento de cuántas filas se han procesado correctamente y cuántas han dado lugar a un error.

Filas procesadas en esta ejecución

Esta tabla proporciona visibilidad a nivel de fila de los datos procesados durante la sincronización, lo que te permite validar registros individuales.

• Buscar: Puedes buscar un usuario específico dentro de los resultados de la ejecución utilizando la barra Buscar por ID de usuario.
• Detalles disponibles:
  • UPDATED_AT: La marca de tiempo de laUPDATED_ATcolumna para esa fila específica.
  • ID: Los identificadores de usuario (como external_id, email, o alias_name) utilizados para relacionar el registro con un perfil de usuario de Braze.
  • Estado: El estado de procesamiento individual de esa fila (éxito o error).
  • Carga útil de origen: Un enlace para ver la carga útil de datos.
  • Motivo del error: Si el estado es Error, esta columna muestra un mensaje que explica por qué la fila no se ha sincronizado.

Visualización de cargas útiles

Para ver los datos exactos enviados a Braze para una fila específica, selecciona Ver carga útil en la columna Carga útil de origen. Esto muestra la carga útil JSON sin procesar que se procesó para ese usuario.

Exportación de registros de sincronización

Selecciona Exportar filas para exportar los registros a nivel de fila de una ejecución de sincronización. A continuación, elige exportar por:

• Filas con errores: Descarga un archivo que contiene solo las filas que tenían un estado de error.
• Todas las filas: Descarga un archivo que contiene todas las filas procesadas en la ejecución.

Los registros no se pueden exportar directamente desde el panel. Una vez generada la exportación, recibirás un correo electrónico con un enlace para descargar el archivo de exportación del registro.

Notificaciones

Puedes configurar notificaciones por correo electrónico para mantenerte informado sobre el estado de tus sincronizaciones CDI. Esta configuración se configura al crear una sincronización y se puede actualizar en cualquier momento.

Notificaciones de error

Se requiere al menos una dirección de correo electrónico de contacto para recibir notificaciones sobre errores de sincronización. Estas alertas se envían cuando un trabajo de sincronización completo no se ejecuta o no se completa, o si la sincronización encuentra un error que requiere la intervención del usuario para cambiarlo, como credenciales caducadas o una tabla de origen que falta.

Las notificaciones adicionales incluyen:

• Error de fila: Recibe alertas cuando un determinado porcentaje de filas no se actualiza durante una sincronización.
• Umbral de fallo (%): Especifica el porcentaje de fallos en las filas que deben desencadenar una alerta. Por ejemplo, si se establece en 1, se enviará una notificación si el 1 % o más de las filas de una sincronización dan lugar a un error.
• Sincronización correcta: Recibe una notificación cuando se complete correctamente una sincronización.
• Alerta incluso si no hay cambios en las filas: Recibe una notificación incluso cuando una sincronización correcta no procesa ninguna fila nueva o actualizada.