Error & Incident Logger
Gruppiert redigierte Fehlerereignisse persistent zu Incidents und verwaltet Severity, Resolution und kontrolliertes Wiederöffnen.
Für Betreiber und Entwickler von Python-Trading-Bots, die technische Störungen nachvollziehbar gruppieren, priorisieren, schließen und bei echter Wiederkehr erneut öffnen möchten.
Welches Problem löst das Modul?
Ein einzelner technischer Fehler kann bei jedem Bot-Zyklus erneut auftreten und dadurch Hunderte fast gleiche Log- oder Alarmmeldungen erzeugen. Zwischen dieser Meldungsflut gehen Ursache, Schwere und tatsächliche Wiederkehr leicht verloren. Error & Incident Logger fasst gleiche Fehler zu einem gemeinsamen Vorfall zusammen, zählt ihr Auftreten und merkt sich, wann der Vorfall begonnen, gelöst oder erneut aufgetreten ist. So sieht der Betreiber die wichtigen Störungen geordnet, statt viele einzelne Wiederholungen durchsuchen zu müssen.
Für welche Börsen ist es geeignet?
- Exchange-unabhängiger Python-Kern
- Für Exchange-, Adapter-, Schutz- und interne Bot-Fehler nutzbar
- Keine Zugangsdaten oder rohen HTTP-Header erforderlich
- JSON-Ledger für einen Prozess oder koordinierten Single-Writer
- Externe Ticket- und Alarmkanäle können den typisierten State konsumieren
Viele gleiche Fehler werden zu einem nachvollziehbaren Incident mit eindeutiger Historie.
Ein stabiler Fingerprint gruppiert Events. Das Modul führt Häufigkeit, erstes und letztes Auftreten sowie höchste Schwere fort. Nur ein zeitlich neues Ereignis nach resolved_at öffnet den Incident wieder; historische Nachlieferungen zählen mit, ohne falschen Reopen.
- 01Fehler vor Übergabe redigieren und stabil fingerprinten
- 02Event idempotent im Ledger speichern
- 03Gleiche Ursache zu einem Incident gruppieren
- 04Höchste Schwere und Zeitfenster aktualisieren
- 05Incident mit stabiler Resolution-ID schließen
- 06Neue Fehler nach Resolution kontrolliert wieder öffnen
Was das Modul technisch übernimmt
- Stabile Event-ID und Ursachen-Fingerprint
- INFO-, WARNING-, ERROR- und CRITICAL-Schwere
- Gruppierung mit first_seen, last_seen und event_count
- Monotone höchste Severity
- Optionaler SHA-256-Hash statt sensibler Rohdetails
- Vollständige Event-Idempotenz
- Resolution mit stabiler resolution_id
- ALREADY_RESOLVED bei identischer Wiederholung
- Kontrolliertes Wiederöffnen nur nach zeitlich neuem Event
- Atomare Ledger-Persistenz und vollständige Zuordnungsvalidierung
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit typisierter API
- Memory-Store und atomarer JSON-Ledger-Store
- 56 automatisierte Tests mit 100,00 Prozent Branch-Coverage
- Vollständige deutsche Kunden-, Datenschutz- und Betriebsanleitung
- Ausführbares Integrationsbeispiel und Beispielkonfiguration
- Wheel und Source Distribution
- Kunden-ZIP mit SHA-256-Prüfsumme
- Kontrollbericht, Release-Checkliste, Changelog und Lizenz
Technische Voraussetzungen
- Python 3.11 oder neuer
- Stabile event_id und normalisierter Ursachen-Fingerprint
- Vor Übergabe redigierte Nachricht ohne Secrets
- Timezone-aware Ereignis- und Resolution-Zeit
- Dauerhafter beschreibbarer Ledger-Pfad
- Definierter Alarm-/Ticket-Consumer
Klare Grenzen
- Fingerprint-Bildung aus Stacktraces ist nicht enthalten
- Keine automatische Ursachenbehebung
- Kein eingebauter Telegram-, E-Mail- oder Ticket-Client
- Lokaler JSON-Store nicht für unabhängige Multi-Host-Schreiber
- Resolution ist Dokumentation und kein Beweis der Ursachenbeseitigung
- Persönliche Integration bleibt separate Leistung
Was nicht enthalten ist
- Keine Speicherung roher Stacktraces oder privater Payloads
- Keine direkte Exchange- oder Telegram-Anbindung
- Kein gehostetes Observability-System
- Keine automatische Ticket-Erstellung
- Keine Compliance- oder Datenschutzberatung
- Keine Handels- oder Gewinnlogik
Die vollständige Anleitung kommt mit dem Modul.
Die öffentliche Seite erklärt Funktion, Lieferumfang und Grenzen. Nach dem Kauf enthält das Paket den vollständigen Code und jeden Einbauschritt. Falls der vorhandene Bot keinen passenden Order-Adapter besitzt, kann persönliche Integration separat angefragt werden.