Das Logging-Modul einmal am Einstiegspunkt konfigurieren

Ziel

Dafür sorgen, dass die Log-Einträge aller Module dasselbe, bewusst konfigurierte Ziel erreichen, mit Levels, die Betreiber ohne Codeänderung anpassen können.

Voraussetzungen

Ein Einstiegspunkt der Anwendung (Main-Funktion, ASGI-Factory), der ausgeführt wird, bevor irgendein Modul loggt.

Schritte

1. In jedem Modul: logger = logging.getLogger(__name__) und sonst nichts; keine Handler, kein basicConfig.
2. Am Einstiegspunkt einmalig konfigurieren: ein Handler (Stream oder Datei), ein Formatter (einfache Zeile oder JSON), das Level des Root- oder Projekt-Loggers, sowie propagate-Entscheidungen für lärmige Third-Party-Logger.
3. Levels nach Zielgruppe wählen: DEBUG für Entwickler, INFO für normale Betriebsereignisse, WARNING für Dinge, die Aufmerksamkeit brauchen, ERROR für fehlgeschlagene Operationen.
4. Das gewünschte Level aus der Konfiguration lesen, damit Betreiber es vorübergehend anheben können.
5. logger.exception(...) innerhalb von except-Blöcken verwenden, um den Traceback einzuschliessen; verzögerte Formatierung nutzen (logger.info("user %s", user_id)), damit Argumente erst gerendert werden, wenn der Eintrag tatsächlich ausgegeben wird.

Erwartetes Ergebnis

Eine Zeile pro Ereignis in einem einheitlichen Format; die Einträge von Drittanbieter-Bibliotheken erscheinen auf dem gewählten Level; keine doppelten Zeilen durch zweifach hinzugefügte Handler.

Grenzen und Prüfbasis

Das Logging-Modul gilt prozessweit; konfigurieren zwei Frameworks es gleichzeitig (zum Beispiel der Root-Handler eines SDK), muss das explizit abgestimmt werden. Strukturierte Ausgabe braucht einen Formatter oder einen kleinen eigenen Handler. Die Anleitung folgt dem zitierten HOWTO.