Voraussetzungen vor dem Start
Der Poller arbeitet im Modus outbox, daher ist die erste Voraussetzung die Umstellung der Einstellung für die Zustellung der Webhooks. Jeder Wert außer outbox bedeutet direct. Deshalb muss man nach der Änderung ein Testereignis auslösen und bestätigen, dass der Eintrag in der Tabelle erschienen ist und nicht direkt versendet wurde.
Die zweite Voraussetzung ist ein technisches Konto für den Poller, dessen Umfang auf das Abrufen von Einträgen und das Bestätigen von Zustellungen beschränkt ist. Die dritte ist ein Netzsegment, aus dem der Poller über einen eingehenden Kanal auf die Anwendung und auf den Endempfänger zugreifen kann. Die vierte ist ein benannter Verantwortlicher für den Workflow auf Seiten der IT.
Ablauf von Abruf und Bestätigung
Der Poller ruft wartende Einträge ab, und das System reserviert atomar ein Paket von bis zu 89 Einträgen unter einer Schreibsperre in einer Transaktion. So holen zwei Poller denselben Eintrag nicht ab, und der Alarm klingelt nicht zweimal. Nach dem Versand bestätigt der Poller jeden Eintrag als delivered oder failed, optional mit einer Fehlerbeschreibung.
Die Bestätigung ist idempotent: Eine Wiederholung der Bestätigung eines bereits zugestellten Eintrags ändert nichts. Das ist bei Netzstörungen wichtig, denn der Poller kann die Bestätigung gefahrlos wiederholen, wenn er keine Antwort erhalten hat.
Wann ein Eintrag in den Pool zurückkehrt
Ein Eintrag im Zustand der Zustellung, dessen Reservierung länger als 300 Sekunden dauert, kehrt in den Pool zurück und kann erneut abgerufen werden. Praktisch heißt das: Der Versand eines einzelnen Pakets sollte nur wenige Minuten dauern, und der Workflow sollte eine eigene Zeitgrenze unter 300 Sekunden haben. Sonst wird dasselbe Paket ein zweites Mal verarbeitet, während die erste Verarbeitung noch läuft.
Grenzen des Mechanismus des Pollers
Wiederholungen und ihre Grenzen
Eine fehlgeschlagene Bestätigung failed setzt den Eintrag in den Zustand wartend zurück und erhöht den Versuchszähler. Der Poller wiederholt den Eintrag daher ohne Ende. Das ist ein Vorteil für Alarme, die nicht verloren gehen dürfen, hat aber Grenzen, die man vor dem Start kennen muss.
Das System hat keine Begrenzung der Versuche, keinen Abstand zwischen den Wiederholungen und keinen Alarm für hängengebliebene Einträge. Ein Eintrag, den der Empfänger dauerhaft ablehnt, etwa wegen einer falschen Adresse, wird immer wieder abgerufen und zurückgegeben. Das belastet den Poller und füllt das Protokoll. Die fehlenden Mechanismen muss man durch eine Prozedur im Workflow ersetzen: einen eigenen Versuchszähler in n8n, einen Abstand zwischen den Versuchen und einen Alarm, wenn ein Eintrag zu oft wiederholt wird.
Ordnung in der Tabelle und Aufsicht
Es gibt keine Aufgabe, die die Tabelle aufräumt, daher wachsen die abgeschlossenen Einträge ohne Ende. Der Administrator sollte eine Aufbewahrungsregel festlegen: wie lange abgeschlossene Einträge aufbewahrt werden und wer sie löscht. Ohne sie wird die Tabelle bei einer Installation mit hohem Aufkommen nach einigen Monaten zu einem Leistungsproblem.
Für die Aufsicht genügen drei Kennzahlen: die Zahl der wartenden Einträge, das Alter des ältesten wartenden Eintrags und die Zahl der Versuche des am häufigsten wiederholten Eintrags. Der Alarm sollte das Alter des ältesten wartenden Eintrags auslösen, denn es zeigt, dass der Poller steht oder der Empfänger nicht antwortet.
Reihenfolge der Inbetriebnahme und Abnahme
Empfohlene Reihenfolge: zuerst eine Testumgebung mit einem fiktiven Empfänger, dann ein Testereignis mit Bestätigung delivered, danach ein Negativtest mit einem Empfänger, der das Ereignis ablehnt (Prüfung, wie sich der Versuchszähler verhält), zuletzt die Umstellung auf den produktiven Empfänger.
Die Abnahme endet mit einem Protokoll: eingestellter Modus, Konto und Umfang, Zeitgrenze des Workflows, Kennzahlen der Aufsicht, Aufbewahrungsregel und Verantwortlicher. Jeder dieser Punkte ist durch einen Nachweis belegt, etwa einen Screenshot der Konfiguration oder einen Eintrag im Protokoll.
Checkliste
Videomaterial
Häufig gestellte Fragen
Wie oft wiederholt der Poller einen fehlgeschlagenen Eintrag?
Ohne Ende. Das System hat weder eine Versuchsgrenze noch einen Abstand zwischen den Wiederholungen, daher müssen die Grenzen im Workflow selbst eingeführt werden.
Können zwei Poller parallel arbeiten?
Ja. Die Reservierung des Pakets ist atomar, daher holen zwei Poller nicht denselben Eintrag ab.
Wer räumt die Tabelle mit den abgeschlossenen Einträgen auf?
Keine Aufgabe des Systems. Der Administrator muss eine Aufbewahrungsregel festlegen und abgeschlossene Einträge regelmäßig löschen.
Poller unter Aufsicht
Wir erarbeiten mit der IT Ihres Werks einen Plan für die Inbetriebnahme des Pollers: Grenzen, Aufsicht und Abnahmeprotokoll.
Sprechen wir