#pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Poco { class TaskManager; } /// \brief Базовый класс для демонов /// /// \code /// # Список возможных опций командной строки обрабатываемых демоном: /// # --config-file или --config - имя файла конфигурации. По умолчанию - config.xml /// # --pid-file - имя PID файла. По умолчанию - pid /// # --log-file - имя лог файла /// # --error-file - имя лог файла, в который будут помещаться только ошибки /// # --daemon - запустить в режиме демона; если не указан - логгирование будет вестись на консоль /// --daemon --config-file=localfile.xml --pid-file=pid.pid --log-file=log.log --errorlog-file=error.log /// \endcode /// /// Если неперехваченное исключение выкинуто в других потоках (не Task-и), то по-умолчанию /// используется KillingErrorHandler, который вызывает std::terminate. /// /// Кроме того, класс позволяет достаточно гибко управлять журналированием. В методе initialize() вызывается метод /// buildLoggers() который и строит нужные логгеры. Эта функция ожидает увидеть в конфигурации определённые теги /// заключённые в секции "logger". /// Если нужно журналирование на консоль, нужно просто не использовать тег "log" или использовать --console. /// Теги уровней вывода использовать можно в любом случае class BaseDaemon : public Poco::Util::ServerApplication { friend class SignalListener; public: BaseDaemon(); ~BaseDaemon(); /// Загружает конфигурацию и "строит" логгеры на запись в файлы void initialize(Poco::Util::Application &); /// Читает конфигурацию void reloadConfiguration(); /// Строит необходимые логгеры void buildLoggers(); /// Определяет параметр командной строки void defineOptions(Poco::Util::OptionSet& _options); /// Заставляет демон завершаться, если хотя бы одна задача завершилась неудачно void exitOnTaskError(); /// Завершение демона ("мягкое") void terminate(); /// Завершение демона ("жёсткое") void kill(); /// Получен ли сигнал на завершение? bool isCancelled() { return is_cancelled; } /// Получение ссылки на экземпляр демона static BaseDaemon & instance() { return dynamic_cast(Poco::Util::Application::instance()); } /// Спит заданное количество секунд или до события wakeup void sleep(double seconds); /// Разбудить void wakeup(); /// Закрыть файлы с логами. При следующей записи, будут созданы новые файлы. void closeLogs(); /// В Graphite компоненты пути(папки) разделяются точкой. /// У нас принят путь формата root_path.hostname_yandex_ru.key /// root_path по умолчанию one_min /// key - лучше группировать по смыслу. Например "meminfo.cached" или "meminfo.free", "meminfo.total" template void writeToGraphite(const std::string & key, const T & value, time_t timestamp = 0, const std::string & custom_root_path = "") { graphite_writer->write(key, value, timestamp, custom_root_path); } template void writeToGraphite(const GraphiteWriter::KeyValueVector & key_vals, time_t timestamp = 0, const std::string & custom_root_path = "") { graphite_writer->write(key_vals, timestamp, custom_root_path); } GraphiteWriter * getGraphiteWriter() { return graphite_writer.get(); } boost::optional getLayer() const { return layer; /// layer выставляется в классе-наследнике BaseDaemonApplication. } protected: /// Возвращает TaskManager приложения /// все методы task_manager следует вызывать из одного потока /// иначе возможен deadlock, т.к. joinAll выполняется под локом, а любой метод тоже берет лок Poco::TaskManager & getTaskManager() { return *task_manager; } virtual void logRevision() const; /// Используется при exitOnTaskError() void handleNotification(Poco::TaskFailedNotification *); /// thread safe virtual void handleSignal(int signal_id); /// реализация обработки сигналов завершения через pipe не требует блокировки сигнала с помощью sigprocmask во всех потоках void waitForTerminationRequest() override; /// thread safe virtual void onInterruptSignals(int signal_id); std::unique_ptr task_manager; /// Создание и автоматическое удаление pid файла. struct PID { std::string file; /// Создать объект, не создавая PID файл PID() {} /// Создать объект, создать PID файл PID(const std::string & file_) { seed(file_); } /// Создать PID файл void seed(const std::string & file_); /// Удалить PID файл void clear(); ~PID() { clear(); } }; PID pid; std::atomic_bool is_cancelled{false}; /// Флаг устанавливается по сообщению из Task (при аварийном завершении). bool task_failed = false; bool log_to_console = false; /// Событие, чтобы проснуться во время ожидания Poco::Event wakeup_event; /// Поток, в котором принимается сигнал HUP/USR1 для закрытия логов. Poco::Thread signal_listener_thread; std::unique_ptr signal_listener; /// Файлы с логами. Poco::AutoPtr log_file; Poco::AutoPtr error_log_file; Poco::AutoPtr syslog_channel; std::unique_ptr graphite_writer; boost::optional layer; std::mutex signal_handler_mutex; std::condition_variable signal_event; std::atomic_size_t terminate_signals_counter{0}; std::atomic_size_t sigint_signals_counter{0}; };