Externes Logging für jeden Integrationsbatch
Jeder Administrate-Integrationsbatch veröffentlicht nun ein lesbares Ausführungsprotokoll an Administrate selbst, damit operationale Teams das Ergebnis überprüfen können, ohne n8n zu öffnen.
Die Herausforderung
Die Integrationen laufen in n8n, aber die Betriebsteams von Administrate sollten keinen Zugriff auf die n8n-Oberfläche benötigen, um zu verstehen, ob eine Synchronisierung erfolgreich war, welche Datensätze abgelehnt wurden oder wo ein Problem auftrat. Der native Ausführungsverlauf allein bot Geschäftsnutzern nicht die richtige Sichtbarkeit.
Die Lösung
Wir haben einen dedizierten externen Logging-Workflow gebaut, der nach jedem in Administrate geschriebenen Batch aufgerufen wird. Er verwandelt technische Ausführungsdaten in ein operatives Protokoll und veröffentlicht es über die GraphQL-API von Administrate.
- Erfasst die Integration, das Quellsystem, den Objekttyp, die Batch-Nummer, den Watermark und die Datensatzsummen.
- Klassifiziert jeden Batch als success, warning oder failed anhand der geschriebenen und abgelehnten Datensätze.
- Veröffentlicht eine prägnante Nachricht plus Details auf Datensatzebene, einschließlich abgelehnter Datensätze und Gründe.
- Verknüpft erfolgreich geschriebene Datensätze, wo verfügbar, und begrenzt Detailansichten für große Batches.
- Verwendet Wiederholungslogik, damit ein vorübergehender Logging-Fehler die operative Sichtbarkeit nicht still entfernt.
Ergebnisse
- Administrate-Teams können die Integrationsgesundheit von ihrer eigenen Plattform aus überprüfen, ohne direkten n8n-Zugriff.
- Jeder Batch hat einen prüfbaren Datensatz aus geschriebenen, abgelehnten und gesamten Datensätzen.
- Abgelehnte Datensätze und Watermarks liefern den Kontext, um Ausnahmen schnell zu untersuchen.
Geschäftsprobleme
- Der Betrieb war auf n8n-Zugriff angewiesen, um zu wissen, ob Integrationen korrekt abgeschlossen wurden
- Technische Ausführungsdaten waren für Geschäftsnutzer nicht verständlich oder ausreichend verfügbar
- Abgelehnte Datensätze hatten keinen konsistenten, für Kunden sichtbaren Audit-Trail
Wesentliche Vorteile
- Der Integrationsstatus ist in Administrate sichtbar, ohne n8n zu öffnen
- Jeder Batch erfasst Summen, Ergebnisse, Watermarks und Gründe für Ablehnungen
- Status success, warning und failure machen Ausnahmen sofort verständlich
- Wiederholungsgeschütztes Publizieren hält den Audit-Trail zuverlässig
Anwendungsdetails
- Dedizierter 4-Knoten-n8n-Workflow, der nach Abschluss der Ziel-Batches aufgerufen wird
- Administrate GraphQL-Mutation: createExternalIntegrationLog
- Pro-Batch Details zu Quelle, Objekttyp, Summen, Watermark und Item-Ergebnis
- Detailansicht großer Batches auf 200 Einträge begrenzt