Protokolle
Syncler stellt zwei Instrumente für Mitteilungen bereit: den Live-Ticker (Nachrichtensystem) und die Protokolle (persistente Lauf- und Ereignisprotokolle).
- Live-Ticker (Broadcast, flüchtig): Echtzeit-Mitteilungen mit begrenztem Volumen von 1500 Nachrichten; neue Nachrichten verdrängen ältere (FIFO).
- Protokolle (persistiert): Umfangreiche, filterbare Lauf-/Ereignisdaten; Aufbewahrung richtet sich nach der konfigurierten Vorhaltezeit und wird durch die tägliche Wartung bereinigt.
Nicht alle Mitteilungen werden dauerhaft gespeichert: Schritt-/Detailmeldungen können ausschließlich im Live-Ticker erscheinen.
Die Stufe „Debugging“ wird nie in Protokollen abgelegt und steht nur im Live-Ticker zur Verfügung.
Dringlichkeitsstufen
Die Protokollierungstiefe ist in Stufen konfigurierbar.
| Stufe | Zweck/Beispiele | Speicherung |
|---|---|---|
| Nachricht | Start/Ende eines Laufs, Statuswechsel, allgemeine Hinweise | Protokoll (optional), Live-Ticker |
| Rückmeldung | Detailierte Lauf-Infos, Datensatz-bezogene Rückmeldungen | Protokoll (empfohlen), Live-Ticker |
| Warnung | Konflikte, unerwartete Zustände, die Syncler selbst auflösen kann | Protokoll + Live-Ticker |
| Fehler | System-, Verarbeitungs- oder Datensatzfehler, u. U. manueller Eingriff nötig | Protokoll + Live-Ticker + (optional) E-Mail |
| Debugging | Sehr ausführliche Ablauf-Infos inkl. Daten/URLs/Requests | nur Live-Ticker |
E-Mail bei Fehlern: Tritt mindestens eine Fehler-Meldung während einer Sync-Ausführung auf, wird eine gesammelte E-Mail je Ausführung an die konfigurierte Adresse versendet.
Protokolle vs. Live-Ticker (Kurzüberblick)
| Merkmal | Live-Ticker | Protokolle |
|---|---|---|
| Zweck | Echtzeit-Monitoring | Nachvollziehbarkeit, Audit, Analyse |
| Volumen | max. 1500 Einträge (Ringpuffer) | durch Vorhaltezeit begrenzt |
| Detailtiefe | hoch, inkl. Debug | konfigurierbar je Stufe |
| Persistenz | nein | ja (tägliche Wartung löscht Altlasten) |
| Zielgruppe | Betrieb in Echtzeit | Betrieb, Analyse, Revision |
Aufbau eines Protokolleintrags
| Feld | Beschreibung |
|---|---|
| Zeitstempel | Erzeugt-Zeit |
| Stufe | Nachricht, Rückmeldung, Warnung, Fehler |
| Bereich | Sync, Report, DQM |
| Bezug | Baustein-ID, Ausführungs-/Warteschlangen-ID, optional Datensatz-IDs |
| Nachricht | Kurztext (menschlich lesbar) |
| Quelle (optional) | System/Objekt, SourceId |
| Snapshot (optional) | Kopie des Quelldatensatzes zum Zeitpunkt der Verarbeitung |
| Tags/Pin (optional) | Markierungen zur Wiederverwendung (Tests/Simulationen) |
Snapshots: Nützlich für Verlauf/Analyse, erhöhen jedoch den Speicherbedarf.
Empfehlung: Bei Initial-Syncs Snapshots deaktivieren, um die Datenbank zu schonen.
Sichtbarkeit & Navigation
Protokolle und Nachrichten sind – je nach Bezug – an unterschiedlichen Stellen einsehbar:
- Baustein (z. B. Sync/Report/DQM): Gesamtsicht mit Filterung.
- Datensatz-Kontext: Datensatz-bezogene Meldungen, sofern IDs zugeordnet sind.
In der Detaildarstellung können einzelne Datensätze identifiziert werden.
Aufbewahrung & Wartung
- Die Vorhaltezeit steuert die Aufbewahrung persistenter Protokolle.
- Die tägliche Wartung entfernt abgelaufene Einträge automatisch.
- Der Live-Ticker ist davon unabhängig und folgt ausschließlich der Volumengrenze.
E-Mail-Benachrichtigungen (Fehler)
- Versand je Ausführung, wenn Fehler auftreten.
- Inhalt: Lauf-Kontext, Anzahl/Beispiele von Fehlern.
- Empfänger: Konfigurierbar auf Baustein-/Systemebene.
Konfiguration & Best Practices
- Stufen gezielt wählen: Nur benötigte Stufen dauerhaft speichern (Debug bleibt im Ticker).
- Snapshots selektiv nutzen: Speicher im Blick behalten; gezielt für Fehlersuche aktivieren.
- Filter & Suche nutzen: Nach Stufe, Bereich, Lauf, IDs, Zeitraum filtern.