Function template make_collector
boost::log::sinks::file::make_collector
Synopsis
template<typename... ArgsT>
shared_ptr< collector > make_collector(ArgsT...const & args);
Description
Функция создает сборщик файлов для заданного целевого каталога. Каждая целевая директория управляется одним коллектором файлов, поэтому, если эта функция называется несколько раз для одной и той же директории, она вернет ссылку на один и тот же коллектор файлов. Безопасно использовать один и тот же коллектор в разных раковинах, даже в многопоточном приложении.
Можно указать определенные ограничения для сохраненных файлов, такие как максимальный общий размер или минимальное свободное пространство, оставленное в каталоге. Если какое-либо из указанных ограничений не выполняется, самый старый сохраненный файл удаляется. Если один и тот же коллектор запрашивается более одного раза с разными ограничениями, коллектор будет действовать в соответствии с наиболее строгим сочетанием всех указанных ограничений.
Поддерживаются следующие названные параметры:
<target>- Указывает целевой каталог для файлов, хранящихся в нем. Этот параметр является обязательным.
<max_size>- Указывает максимальный общий размер в байтах хранимых файлов, который коллектор будет стараться не превышать. Если размер превышает этот порог, самый старый файл (файлы) удаляется в свободное пространство. Обратите внимание, что порог может быть превышен, если размер отдельных файлов превышает значение<max_size>. Порог не поддерживается, если не уточняется.
<min_free_space>— Указывает минимальное свободное пространство, в байтах, в целевой директории, которую пытается поддерживать коллектор. Если порог превышен, самый старый файл (файлы) удаляется в свободное пространство. Порог не поддерживается, если не уточняется.
<max_files>— указывает максимальное количество хранящихся лог-файлов. Если количество файлов превышает этот порог, самый старый файл удаляется в свободное пространство. Порог не поддерживается, если не уточняется.
Возвращение: |
Файловый коллектор. |
