挑战

集成在 n8n 中运行，但 Administrate 的运营团队不应该需要访问 n8n 界面来了解同步是否成功、哪些记录被拒绝或问题出在哪里。仅靠原生执行历史无法为业务用户提供正确的可见性。

解决方案

我们构建了一个专门的外部日志工作流程，在每次写入 Administrate 的批次后调用。它将技术执行数据转换为运营日志，并通过 Administrate 的 GraphQL API 发布。

• 捕获集成、源系统、对象类型、批次号、watermark 和记录总数。
• 根据写入和拒绝的记录数将每个批次分类为 success、warning 或 failed。
• 发布简洁消息以及记录级详情，包括被拒绝的记录和原因。
• 在可用时链接成功写入的记录，并对大批次安全限制详情视图。
• 使用重试逻辑，使临时日志记录失败不会静默移除运营可见性。

结果

• Administrate 团队可以从自己的平台查看集成健康状况，无需直接访问 n8n。
• 每个批次都有写入、拒绝和总记录的可审计记录。
• 被拒绝的记录和 watermark 提供了快速调查异常所需的上下文。