Configuration Deep Dive

1. ⚙️ Configuration Deep Dive

Die Logs.configure() Methode bietet eine zentrale Kontrolle über File-Rotation, Sicherheits-Features und Ausgabeformate.

Logs.configure(...) Parameter-Referenz

Parameter	Typ	Standard	Beschreibung
min_level	LogLevel	INFO	Definiert das unterste Level, das an Konsole UND File ausgegeben wird.
log_file	str	None	Pfad zur Log-Datei. Aktiviert File-Logging.
max_file_size	int	10 MB	Rotation: Maximale Größe der Log-Datei in Bytes.
backup_count	int	3	Rotation: Anzahl der zu behaltenden rotierten Backups.
enable_compression	bool	False	Rotation: Komprimiert rotierte Dateien in das GZip-Format (.gz).
format_type	LogFormat	STANDARD	Die Format-Vorlage: SIMPLE, STANDARD, DETAILED, JSON.
show_metadata	bool	False	Fügt Quelldatei, Zeilennummer und aufrufende Funktion zum Log-Eintrag hinzu.
environment	str	DEV	Intelligent: Definiert die Umgebung. Steuert die Environment-Aware Coloring.

JSON-Format und Strukturierte Logs

LogFormat.JSON ist die Best Practice für Produktion, da es alle Metadaten (kwargs) als strukturierte Felder für Log-Aggregatoren speichert.

# Log-Aufruf
Logs.warn(
    Category.CACHE, 
    "Hit rate niedrig", 
    rate_percent=0.45, 
    key="user_session"
)

# JSON-Output (Auszug)
# {
#   "level": "WARN", 
#   "category": "CACHE", 
#   "message": "Hit rate niedrig",
#   "rate_percent": 0.45,
#   "key": "user_session",
#   "thread_name": "MainThread" 
# }