CTsLogger - это простая и гибкая система логирования, специально разработанная для создания и отладки торговых систем на MQL5. Основным преимуществом CTsLogger является возможность временно включать режим отладки для определенных модулей или участков кода, сохраняя при этом более низкий глобальный уровень логирования. Это позволяет получить подробное логирование определенных участков кода, не "утопая" в потоке сообщений, а затем отключить его одной командой.
Ключевые преимущества
- Простота использования: Минимальная инициализация и простое обращение к методам протоколирования
- Гибкость отладки: Возможность включить режим отладки для отдельных модулей даже при низком глобальном уровне протоколирования
- Иерархическая структура: Поддержка иерархических идентификаторов модулей для логической организации
- Управление состоянием: Возможность приостанавливать и возобновлять режим отладки без потери настроек
- Надежность: Продолжает работать даже при ошибках файловой системы (изящная деградация до терминального вывода)
- Минимальные зависимости: Работает независимо, не требуя других компонентов
Уровни протоколирования
CTsLogger поддерживает 4 уровня протоколирования, в порядке возрастания детализации:
- LOG_LEVEL_ERROR - только ошибки
- LOG_LEVEL_WARNING - предупреждения и ошибки
- LOG_LEVEL_INFO - информационные сообщения, предупреждения и ошибки
- LOG_LEVEL_DEBUG - отладочные сообщения, информационные сообщения, предупреждения и ошибки
Полный API
Создание и инициализация
- CTsLogger() - конструктор
- ~CTsLogger() - деструктор
- Initialize(string logFileName, bool logToTerminal = true) - инициализация логгера
- SetGlobalLogLevel(ENUM_LOG_LEVEL level) - установка уровня глобального протоколирования
Методы протоколирования
- Error(string moduleId, string message) - протоколирование ошибок
- Warning(string moduleId, string message) - ведение журнала предупреждений
- Info(string moduleId, string message) - регистрация информационных сообщений
- Debug(string moduleId, string message) - регистрация отладочных сообщений
Базовое управление режимом отладки
- EnableDebugMode(string moduleId) - включить режим отладки для модуля
- DisableDebugMode(string moduleId) - отключить режим отладки для модуля и всех его дочерних модулей
- IsInDebugMode(string moduleId) - проверить, включен ли режим отладки
- EnableDebugModeAll() - включить режим отладки для всех модулей
- DisableDebugModeAll() - отключить глобальный режим отладки с сохранением настроек модулей
Расширенное управление режимом отладки
- PauseDebugMode() - временно приостановить режим отладки для всех модулей
- ResumeDebugMode() - возобновить режим отладки для ранее настроенных модулей
- IsDebugModePaused() - проверить, приостановлен ли режим отладки
- ResetDebugModules() - полностью сбросить все отладочные модули
- HasChildDebugModules(string parentModule) - проверка наличия дочерних модулей в режиме отладки
Дополнительную информациюсм. в файле CTsLogger-ReadMe.txt.