Inhalt
- Schnittstellen-Monitoring: das Problem stiller Ausfälle
- Praxisbeispiel: Wochenlang keine Belege
- Das Fehlerprotokoll: ein Ort für alle Fehler
- Heartbeat-Prüfung: Wenn zu lange nichts passiert
- Alarmierung: Wer erfährt es, und wie?
- Wiederholversuche und Idempotenz, einfach erklärt
- Dokumentation und Verantwortliche
- Fazit
- Häufige Fragen
Das Wichtigste in Kürze
- Das größte Risiko bei Schnittstellen sind stille Ausfälle, bei denen kein Fehler gemeldet wird, aber einfach keine Daten mehr ankommen.
- Ein gutes Schnittstellen-Monitoring kombiniert ein zentrales Fehlerprotokoll mit einer Heartbeat-Prüfung, die Alarm schlägt, wenn zu lange keine neuen Datensätze eintreffen.
- Wiederholversuche sind nur dann sicher, wenn die Verarbeitung idempotent ist, also ein doppelt verarbeiteter Datensatz zum selben Ergebnis führt statt zu einer Dublette.
- Jede Integration braucht einen kurzen Steckbrief und eine verantwortliche Person mit Vertretung, die bei einem Alarm weiß, was zu tun ist.
Schnittstellen-Monitoring: das Problem stiller Ausfälle
Wenn eine Schnittstelle mit einer Fehlermeldung abbricht, ist das unangenehm, aber ehrlich. Irgendwer bekommt eine Meldung, schaut nach und behebt das Problem. Viel gefährlicher sind Ausfälle, bei denen nichts abbricht. Die Strecke läuft, meldet „erfolgreich“, aber es kommen keine Daten mehr an.
Typische Ursachen für solche stillen Ausfälle sind:
- Zugangsdaten oder Berechtigungen ändern sich, und die Abfrage liefert statt eines Fehlers einfach eine leere Liste.
- Ein Update im Quellsystem benennt ein Feld um, und ein Filter lässt ab sofort nichts mehr durch.
- Ein Ablauf wurde zum Testen deaktiviert und nie wieder eingeschaltet.
- Eine Zustimmung oder ein Zugangstoken läuft ab, etwa bei Bankanbindungen über PSD2.
- Fehlermeldungen gehen an ein Postfach, das niemand liest, oder an eine Person, die das Unternehmen verlassen hat.
Allen Fällen ist gemeinsam: Die Technik sieht keinen Fehler, also gibt es keine Meldung. Deshalb reicht es nicht, nur auf Fehler zu reagieren. Gutes Monitoring prüft auch, ob das Erwartete tatsächlich passiert.
Praxisbeispiel: Wochenlang keine Belege
In einem Projekt ist genau das passiert: Eine Belegstrecke zwischen zwei Systemen fiel aus, und es merkte wochenlang niemand. Es gab keine Fehlermeldung, also auch keinen Anlass, nachzusehen.
Wie so etwas entstehen kann, zeigt eine typische Ursache: Im Quellsystem wird zum Beispiel das Rechtekonzept überarbeitet, und der technische Benutzer der Schnittstelle verliert dabei das Leserecht auf die Belege. Die Abfrage läuft weiter, bekommt aber eine leere Ergebnisliste zurück. Aus Sicht der Middleware ist alles in Ordnung: kein Fehler, nur eben keine neuen Belege.
Bemerkt wird so ein Ausfall dann oft zufällig, etwa wenn jemand im Vertrieb bei einem Kunden aktuelle Belege vermisst. Danach beginnt die Aufräumarbeit: fehlende Belege nachladen, prüfen, ob dabei Dubletten entstehen, und Auswertungen der vergangenen Wochen korrigieren.
Das eigentliche Problem ist dabei nicht die Ursache selbst. Rechteänderungen, Updates und abgelaufene Zugänge passieren. Das Problem ist, dass niemand prüft, ob überhaupt noch Daten fließen. Eine einfache Heartbeat-Prüfung meldet einen solchen Ausfall innerhalb von Stunden statt Wochen. Zusammen mit einem Fehlerprotokoll und klaren Zuständigkeiten gehört sie deshalb zu den ersten Dingen, die bei bestehenden Integrationen nachgerüstet werden sollten.
Das Fehlerprotokoll: ein Ort für alle Fehler
Viele Unternehmen haben mehrere Integrationen, oft in verschiedenen Werkzeugen. Jede meldet Fehler auf ihre eigene Art: per E-Mail, im Ausführungsverlauf der Plattform oder gar nicht. Das Erste, was ich deshalb einführe, ist ein zentrales Fehlerprotokoll. Das kann eine Tabelle in einer Datenbank sein oder ein eigenes Objekt im CRM. Wichtig ist, dass alle Strecken dorthin schreiben.
Ein Eintrag enthält mindestens:
- Zeitpunkt und Name der Strecke
- betroffener Datensatz, etwa Beleg- oder Kundennummer
- Fehlermeldung im Original und eine kurze Einordnung
- Status: neu, in Klärung, erledigt oder erneut verarbeitet
- wer den Fall bearbeitet
Die meisten Middleware-Plattformen bieten dafür Bausteine. In Make lassen sich Fehlerrouten an einzelne Schritte hängen, in n8n kannst du einen eigenen Fehler-Workflow hinterlegen, der bei jedem fehlgeschlagenen Lauf startet. Dieses Fehlermodul schreibt den Eintrag ins Protokoll und löst bei Bedarf eine Benachrichtigung aus. Bei selbst programmierten Schnittstellen übernimmt das ein gemeinsamer Baustein im Code.
Der Nutzen zeigt sich nach einigen Wochen. Du siehst, welche Strecken häufig Probleme haben, welche Fehler sich wiederholen und wo eine Ursache dauerhaft behoben werden sollte. Ein fester Termin, an dem jemand das Protokoll durchgeht, gehört dazu.
Heartbeat-Prüfung: Wenn zu lange nichts passiert
Heartbeat heißt Herzschlag, und das Bild passt: Solange das Herz schlägt, lebt der Patient. Übertragen auf Schnittstellen heißt das, du prüfst regelmäßig, ob die erwarteten Daten angekommen sind. Wenn nicht, gibt es Alarm, auch wenn kein einziger Fehler gemeldet wurde.
Beispiele für solche Prüfungen:
- „Seit vier Stunden sind an einem Werktag während der Geschäftszeit keine neuen Aufträge im CRM angekommen.“
- „Bis 9 Uhr ist kein Kontoauszug vom Vortag eingegangen.“
- „Heute sind weniger als halb so viele Belege übertragen worden wie an einem üblichen Werktag.“
- „Der letzte erfolgreiche Lauf der nächtlichen Synchronisation liegt mehr als 26 Stunden zurück.“
Die Schwellenwerte sind Beispiele. Sie hängen von deinem Geschäft ab und sollten so gewählt sein, dass sie echte Ausfälle melden, aber nicht an jedem ruhigen Nachmittag. Wochenenden, Feiertage und Betriebsferien gehören in die Regel, sonst gibt es Fehlalarme.
Alarmierung: Wer erfährt es, und wie?
Ein Alarm, den niemand liest, ist keiner. Bei der Alarmierung kommt es auf drei Fragen an.
Erstens: Wohin geht die Meldung? Nicht an persönliche Postfächer, sondern an eine Rolle, etwa einen Verteiler oder einen Kanal im Team-Chat. So überlebt die Alarmierung Urlaub und Personalwechsel.
Zweitens: Wie dringend ist es? Ich unterscheide meist zwei Stufen. Einzelne Fehler, etwa ein Datensatz mit ungültiger E-Mail-Adresse, landen im Protokoll und werden gesammelt bearbeitet. Ausfälle einer ganzen Strecke lösen sofort eine Meldung aus. Wer alles sofort meldet, erzeugt Alarmmüdigkeit, und nach ein paar Wochen ignoriert das Team auch die wichtigen Meldungen.
Drittens: Was passiert, wenn niemand reagiert? Bleibt ein Alarm eine festgelegte Zeit unbearbeitet, geht er an die nächste Stufe, etwa die Vertretung oder die Teamleitung.
Wiederholversuche und Idempotenz, einfach erklärt
Nicht jeder Fehler ist ein echtes Problem. Viele sind vorübergehend: Das Zielsystem antwortet nicht rechtzeitig, ist kurz überlastet oder meldet, dass in kurzer Zeit zu viele Anfragen kamen. Solche Fehler lösen sich oft von selbst, wenn man es etwas später noch einmal versucht. Andere Fehler sind dauerhaft: falsche Zugangsdaten, ein Pflichtfeld fehlt, ein Wert ist ungültig. Da hilft kein zweiter Versuch, da muss ein Mensch ran.
Wiederholversuche mit wachsenden Pausen
Bewährt haben sich automatische Wiederholversuche nur für vorübergehende Fehler, mit wachsenden Pausen dazwischen, etwa nach einer, fünf und dreißig Minuten. Nach einer festen Zahl von Versuchen landet der Fall im Fehlerprotokoll. So überbrückt die Strecke kurze Störungen, ohne das Zielsystem zusätzlich zu belasten.
Idempotenz: einmal oder dreimal, gleiches Ergebnis
Wiederholungen haben eine Tücke. Stell dir vor, die Schnittstelle schickt einen Auftrag ans CRM, das CRM legt ihn an, aber die Bestätigung geht unterwegs verloren. Die Schnittstelle hält das für einen Fehler und versucht es erneut. Ergebnis: Der Auftrag steht zweimal im CRM.
Die Lösung heißt Idempotenz. Ein Vorgang ist idempotent, wenn es egal ist, ob er einmal oder dreimal ausgeführt wird. Das Ergebnis ist dasselbe. Ein Alltagsbeispiel: Der Befehl „Licht an“ ist idempotent, egal wie oft du ihn gibst. Der Befehl „Licht umschalten“ ist es nicht.
Doppelverarbeitung vermeiden
In der Praxis erreichst du Idempotenz mit wenigen Mitteln:
- Jeder Datensatz trägt einen eindeutigen Schlüssel aus dem Quellsystem, zum Beispiel die Belegnummer.
- Die Schnittstelle schreibt per „Upsert“: Gibt es den Schlüssel schon, wird aktualisiert, sonst angelegt. Ein blindes „Neu anlegen“ gibt es nicht.
- Bei Vorgängen, die etwas auslösen, etwa eine E-Mail oder eine Zahlung, merkt sich die Strecke, welche Vorgänge bereits verarbeitet wurden, und überspringt Wiederholungen.
- Manche Schnittstellen, gerade bei Zahlungsanbietern, unterstützen einen Idempotenzschlüssel, den du bei jeder Anfrage mitschickst. Kommt dieselbe Anfrage zweimal, führt das System sie nur einmal aus.
Mit diesen Regeln kannst du fehlgeschlagene Läufe gefahrlos wiederholen. Das ist auch die Grundlage dafür, nach einem Ausfall wie im Praxisbeispiel Daten nachzuladen, ohne Dubletten zu erzeugen. Wie eindeutige Schlüssel zwischen CRM und ERP aussehen, beschreibe ich im Artikel CRM und ERP verbinden.
Dokumentation und Verantwortliche
Die beste Überwachung hilft wenig, wenn im Alarmfall niemand weiß, was die Strecke tut. Für jede Integration lege ich deshalb einen kurzen Steckbrief an, eine Seite reicht:
- Zweck der Strecke und beteiligte Systeme
- was in welche Richtung fließt und wie oft
- welcher technische Benutzer verwendet wird und welche Rechte er braucht
- Ablaufdaten von Zugangstoken, Zertifikaten oder Zustimmungen
- welche Heartbeat-Prüfung und welche Alarmierung greifen
- wie die Strecke nach einem Ausfall sicher nachläuft
- fachlich und technisch verantwortliche Person mit Vertretung
Die Trennung zwischen fachlicher und technischer Verantwortung ist wichtig. Die technische Seite kümmert sich um Zugänge, Fehler und Wiederanlauf. Die fachliche Seite beurteilt, ob die Daten stimmen und was ein Ausfall fürs Geschäft bedeutet. Bei Bankanbindungen gehört zum Beispiel die Erneuerung der Zustimmung oder der Austausch von Schlüsseln in den Kalender der zuständigen Person. Mehr dazu findest du im Artikel Kontoauszüge automatisch ins CRM holen.
Zwei Regeln haben sich besonders bewährt: Schnittstellen laufen über technische Benutzer, nie über das persönliche Konto einer Mitarbeiterin. Und Rechteänderungen in einem angebundenen System werden vorher mit der verantwortlichen Person abgestimmt. Bei einer Ursache wie der Rechteänderung aus dem Beispiel hätte die zweite Regel den Ausfall verhindert. Eine Heartbeat-Prüfung macht ihn unabhängig von der Ursache früh sichtbar.
Fazit
Schnittstellen fallen aus, das lässt sich nicht verhindern. Entscheidend ist, wie schnell du es merkst und wie sicher du danach wieder auf Stand kommst. Mit einem zentralen Fehlerprotokoll, einer Heartbeat-Prüfung pro Strecke, einer Alarmierung an Rollen statt Personen und idempotenter Verarbeitung werden aus Wochen Stunden. Mein Rat für den ersten Schritt: Liste alle Integrationen auf und schreibe zu jeder einen Satz, woran du merken würdest, dass sie seit gestern nichts mehr tut. Wo dir keine Antwort einfällt, fängst du an. Wenn du dabei Unterstützung möchtest, findest du mehr zu meinem Angebot rund um Automatisierung und Schnittstellen.
Häufige Fragen
Weißt du, ob deine Schnittstellen gerade laufen?
Ich prüfe deine bestehenden Integrationen, ergänze Fehlerprotokoll, Heartbeat-Prüfungen und Alarmierung und dokumentiere, wer bei welchem Fehler was tut. So fällt ein Ausfall auf, bevor er Kunden, Buchhaltung oder Vertrieb trifft.