CTsLogger - Simple and Flexible Logger - Bibliothek für den MetaTrader 5

CTsLogger ist ein einfaches und flexibles Protokollierungssystem, das speziell für die Erstellung und das Debugging von Handelssystemen in MQL5 entwickelt wurde. Der Hauptvorteil von CTsLogger ist die Möglichkeit, den Debug-Modus für bestimmte Module oder Codeabschnitte vorübergehend zu aktivieren, während ein niedrigerer globaler Logging-Level beibehalten wird. So können Sie eine detaillierte Protokollierung bestimmter Codebereiche erhalten, ohne in einer Flut von Meldungen zu "ertrinken", und diese dann mit einem einzigen Befehl deaktivieren.

Wichtigste Vorteile

- Einfacher Gebrauch: Minimale Initialisierung und einfacher Aufruf von Protokollierungsmethoden

- Flexibilität bei der Fehlersuche: Möglichkeit, den Debug-Modus für einzelne Module zu aktivieren, selbst bei einem niedrigen globalen Logging-Level

- Hierarchische Struktur: Unterstützung für hierarchische Modulbezeichner zur logischen Organisation

- Zustandsverwaltung: Möglichkeit, den Debug-Modus anzuhalten und fortzusetzen, ohne Einstellungen zu verlieren

- Verlässlichkeit: Funktioniert auch bei Dateisystemfehlern weiter (graceful degradation to terminal output)

- Minimale Abhängigkeiten: Arbeitet unabhängig, ohne andere Komponenten zu benötigen

Logging-Stufen

CTsLogger unterstützt 4 Protokollierungsebenen, in der Reihenfolge zunehmender Ausführlichkeit:

1. LOG_LEVEL_ERROR - nur Fehler
2. LOG_LEVEL_WARNING - Warnungen und Fehler
3. LOG_LEVEL_INFO - Informationsmeldungen, Warnungen und Fehler
4. LOG_LEVEL_DEBUG - Debug-Meldungen, Informationsmeldungen, Warnungen und Fehler

Vollständige API

Erstellung und Initialisierung

• CTsLogger() - Konstruktor
• ~CTsLogger() - Destruktor
• Initialize(string logFileName, bool logToTerminal = true) - Initialisierung des Loggers
• SetGlobalLogLevel(ENUM_LOG_LEVEL level) - Einstellen des globalen Logging-Levels

Logging-Methoden

• Error(string moduleId, string message) - Fehlerprotokollierung
• Warning(string moduleId, string message) - Warnungsprotokollierung
• Info(string moduleId, string message) - Protokollierung von Informationsmeldungen
• Debug(string moduleId, string message) - Protokollierung von Debug-Meldungen

Grundlegende Steuerung des Debug-Modus

• EnableDebugMode(string moduleId) - aktiviert den Debug-Modus für ein Modul
• DisableDebugMode(string moduleId) - Deaktiviert den Debug-Modus für ein Modul und alle seine untergeordneten Module
• IsInDebugMode(string moduleId) - prüft, ob der Debug-Modus aktiviert ist
• EnableDebugModeAll() - aktiviert den Debug-Modus für alle Module
• DisableDebugModeAll() - Deaktiviert den globalen Debug-Modus unter Beibehaltung der Moduleinstellungen

Erweiterte Kontrolle des Debug-Modus

• PauseDebugMode() - unterbricht vorübergehend den Debug-Modus für alle Module
• ResumeDebugMode() - setzt den Debug-Modus für zuvor konfigurierte Module fort
• IsDebugModePaused() - prüft, ob der Debug-Modus pausiert ist
• ResetDebugModules() - setzt alle Debug-Module vollständig zurück
• HasChildDebugModules(string parentModule) - prüft auf untergeordnete Module im Debug-Modus

Siehe CTsLogger-ReadMe.txt für weitere Informationen.