Logging externo para cada lote de integración
Cada lote de integración de Administrate publica ahora un log de ejecución legible en Administrate, para que los equipos operativos revisen el resultado sin entrar en n8n.
El reto
Las integraciones se ejecutan en n8n, pero los equipos operativos de Administrate no deberían necesitar acceso a su interfaz para saber si una sincronización terminó correctamente, qué registros fueron rechazados o dónde se produjo una incidencia. El histórico nativo de ejecuciones no ofrecía la visibilidad adecuada para usuarios de negocio.
La solución
Construimos un workflow dedicado de logging externo que se llama después de cada lote escrito en Administrate. Convierte los datos técnicos de ejecución en un log operativo y lo publica mediante la API GraphQL de Administrate.
- Captura integración, sistema de origen, tipo de objeto, número de lote, watermark y totales de registros.
- Clasifica cada lote como success, warning o failed según los registros escritos y rechazados.
- Publica un mensaje conciso junto con detalle por registro, incluidos los rechazados y sus motivos.
- Enlaza los registros escritos cuando están disponibles y limita de forma segura el detalle de lotes grandes.
- Usa reintentos para que un fallo temporal al registrar no elimine silenciosamente la visibilidad operativa.
Resultados
- Los equipos de Administrate revisan la salud de las integraciones desde su propia plataforma, sin acceso directo a n8n.
- Cada lote tiene un registro auditable de registros escritos, rechazados y totales.
- Los registros rechazados y los watermarks aportan el contexto necesario para investigar excepciones rápidamente.
Problemas de Negocio
- Operaciones dependía del acceso a n8n para saber si las integraciones se habían completado correctamente
- Los datos técnicos de ejecución no eran suficientemente comprensibles ni accesibles para usuarios de negocio
- Los registros rechazados no tenían una trazabilidad consistente y visible para el cliente
Beneficios Clave
- El estado de las integraciones es visible en Administrate sin abrir n8n
- Cada lote registra totales, resultados, watermarks y motivos de rechazo
- Los estados success, warning y failed hacen entendibles las excepciones de inmediato
- La publicación protegida con reintentos mantiene fiable la trazabilidad
Detalles de la Aplicación
- Workflow dedicado de n8n de 4 nodos llamado al terminar los lotes destino
- Mutación GraphQL de Administrate: createExternalIntegrationLog
- Detalle por lote de origen, tipo de objeto, totales, watermark y resultado por registro
- El detalle de lotes grandes se limita a 200 registros para logs legibles