Logging
Überblick
Die Schnittstelle protokolliert alle Sync-Vorgänge in Logdateien. Die Logdateien können über das Management Interface eingesehen und heruntergeladen werden.
Debug-Stufen:
| Flag | Level | Beschreibung |
|---|---|---|
-d |
ERROR | Nur Fehlermeldungen (Standard) |
-dd |
WARNING | Fehler und Warnungen |
-ddd |
INFO | Fehler, Warnungen und Informationen |
-dddd |
DEBUG | Alle Meldungen inkl. Debug-Ausgaben |
Die Debug-Stufe kann pro Shop in der management.ini oder beim manuellen Start über die erweiterte Ansicht im Management Interface eingestellt werden.
Manuelle Konfiguration
Die Logausgaben können optional manuell konfiguriert werden.
Eine Beispielkonfiguration findet sich in der Datei logging.cfg.
Wird diese Datei im Programmverzeichnis gefunden, wird die Logkonfiguration aus dieser gelesen. Der Dateiaufbau entspricht dabei dem Python-Standard.
Es stehen folgende Variablen zur Verfügung.
| Variable | Beschreibung |
|---|---|
| %(logfolder)s | Das Verzeichnis für Logdateien für den Mandanten |
| %(filename)s | Der Dateiname für die Übertragungsart (syncProducts, syncPrices etc.) |
Existiert in der Konfiguration ein Logger mit dem Namen baseHandler, so werden in diesen alle
Lognachrichten für die laufende Übertragung geschrieben.
E-Mail-Benachrichtigungen
Über die [MAIL]-Sektion in der config.ini können Fehlerbenachrichtigungen per E-Mail versendet werden. Die Schnittstelle verwendet einen BufferingSMTPHandler, der Log-Nachrichten puffert und gesammelt per E-Mail versendet.
[MAIL]
; SMTP-Server
server =
; SMTP-Port
port = 0
; STARTTLS verwenden
use_tls = False
; SMTP-Benutzername
username =
; SMTP-Passwort
password =
; Betreff-Prefix
subject_prefix = [SHOPWARE FEHLERLOG]
; Absender-Adresse
sender =
; Empfänger-Adresse
receiver =
; Maximale Anzahl gepufferter Nachrichten
capacity = 1000
; Log-Level für E-Mail-Versand
level = DEBUG
; E-Mail-Versand aktivieren
tosend = False
Um den E-Mail-Versand zu aktivieren, muss tosend = True gesetzt und ein gültiger SMTP-Server konfiguriert werden. Bei aktiviertem use_tls wird STARTTLS für die Verbindung verwendet.
Plugin-Logger / Debug-Modus
Um das Logging für die Plugins zu aktivieren, muss in die logging.cfg folgender Block eingefügt werden bzw. der Log-Level muss auf DEBUG gesetzt werden:
[logger_shop.plugins]
level=DEBUG
handlers=consoleHandler,baseHandler
qualname=shop.plugins
propagate=0