首页 > 其他分享 >【Boost】boost.log 要点笔记

【Boost】boost.log 要点笔记

时间：2023-08-22 09:02:35浏览次数：33  
标签：log boost sink file logger include Boost

常用简写：

namespace logging = boost::log;
namespace src = boost::log::sources;
namespace expr = boost::log::expressions;
namespace sinks = boost::log::sinks;
namespace attrs = boost::log::attributes;
namespace keywords = boost::log::keywords;

要点：

  1. 结构图要牢记在心；
  2. trivial头文件可用于一般的控制台输出，日志等级被定义在改头文件；
  3. 全局日志等级过滤使用logging::core::get()->set_filter();
  4. 如果不仅仅需要简单的控制台输出，这时候就要添加sink，使用logging::add_file_log可添加文件sink后端，格式如下：
logging::add_file_log
(   
        keywords::file_name="sample_%N.log",        //文件名格式
        keywords::rotation_size=10*1024*1024,       //超过此大小自动建立新文件
        keywords::time_based_rotation=sinks::file::rotation_at_time_point(0,0,0),   //每隔指定时间重建新文件
        keywords::format="[%TimeStamp%]:%Message%"      //日志消息格式
);

除了这种语法外，也可以建立sinks::text_file_backend后端，用之初始化一个sink。 file rotation的选项有很多，可以指定日期、时间间隔、文件大小，甚至可以指定自己的谓词。 此外，可以设置在建立新文件后首先执行(sink->locked_backend()->set_open_handler(xx))，以及rotation之前最后执行的语句。 可以综合管理这些日志文件，限制输出文件夹，日志总大小限制，以及最低磁盘空间限制。如下：

sink->locked_backend()->set_file_collector(sinks::file::make_collector(
        keywords::target="logs",                //目标文件夹
        keywords::max_size=16*1024*1024,        //所有日志加起来的最大大小,
        keywords::min_free_space=100*1024*1024  //最低磁盘空间限制
        ));

如果多个后端制定了相同的存放文件夹，限制取其中最严格的，另外，注意避免不同后端日志的命名冲突问题。 注意使用sink->locked_backend()->scan_for_files() 来扫描其他实例建立的日志文件。

以上都是使用程序本身使用单日志文件的情况，如果需要根据请求的不同将消息分发到不同的文件，可以使用sinks::text_mutlifile_backend。该后端常用于多线程调试。

  1. 除了文件后端，更常用的是文本流后端sinks::text_ostream_backend，与别的后端不同，文本流后端可以添加多个输出对象，这些对象由于都在同一个sink中，所以输出格式是一样的，这种做法的性能比添加文件后端更高，但是会失去对文件的控制能力。
  2. 对于大规模应用程序，为了方便查看记录，各模块的日志应该相互独立，因此一个 logger 一般是不够的，我们需要自己建立 logger。logger 的建立方法很简单，new一个 src::logger 就可以了…

如果真的只需要一个logger，除了使用前面提到的trivial中的宏以外，也可以用BOOST_LOG_INLINE_GLOBAL_LOGGER_DEFAULT(my_logger,src::logger_mt)，自己定义属于自己的全局logger。然后在需要的时候使用src::logger_mt& lg=my_logger::get()获得logger的单例引用（这里最好是线程安全的logger，显然）。

logger的使用方法：

logging::record rec=log.open_record();
if(rec)
{
        logging::record_ostream strm(rec);
        strm<<"Hello,World!";
        strm.flush();
        lg.push_record(boost::move(rec));
}

以上可以简化成一个宏：BOOST_LOG(lg)<<"Hello World"

  1. attribute是log record的附加信息，不同于一般的消息记录，属性可以被单独拿出来处理，作为某种过滤条件，或者其他使用。属性分为全局属性，特定线程属性和特定源的属性。

常用的属性，如时间戳、计数器，boost.log都已经有实现好的版本，直接使用logging::add_common_attributes() 可以一次性获得LineID, TimeStamp, ProcessID, ThreadID 这些常用属性（单线程程序没有线程ID）。

可以自己注册安全等级，定义相关枚举，然后使用其作为src::serverity_logger<>的模板参数初始化，就得到了自定义Severity属性的logger。这种logger可以使用BOOST_LOG_SEV(logger,serverity)来记录。

特定范围的属性可以用来做一些特殊日志，比如需要评估性能的地方可以使用BOOST_LOG_SCOPED_THREAD_ATTR("Timeline",attrs::timer());注册一个时间线标签。

此外，可以给属性定义占位符，相当于注册为关键字，方便在流中使用。关于属性的函数大多定义在expr命名空间里面。

  1. 格式化输出消息，前文有set_formatter的用法。格式化消息可以使用stl格式expr::stream<<xxx，也可以使用boost::format格式，即expr::format("%1%)%xxx这种。

为了取得最大灵活性，可以自定义一个formatter。

  1. 过滤子，如前文，可以使用sink.set_filter来设置，可以使用的过滤条件包括布尔表达式和lambda表达式等，如果想要确定有没有某个属性，可使用expr::has_attr()。

  2. 宽字符。使用windows的话，这块算是最恶心的部分了

辅助函数

boost.log定义了大量辅助函数实现常用功能。

logging::add_console_log()可以直接添加控制台sink，返回boost::shared_ptr<sinks::synchronous_sink<sinks::text_ostream_backend>>，可利用返回值设置过滤器或其他属性。

logging::add_file_log()，前文已经提过，可以直接得到文件sink…

最后logging::add_common_attributes可以获得常用属性，前文也有详解。

示例

完全封装boost.log的工程量比较大，不过对于小规模工程，使用一个初始化函数就足够了，但是这会导致整个项目与boost深度耦合。

/*
 *  FILE: boost.log.init.hpp
 *  INSTRUCTION: 这个文件用于初始化boost.log
 *  DETAIL: 这里重新定义了日志级别和对应的文本内容. 
 *          文件大小限制等信息被硬编码在cpp文件中，如有需求可以修改。
 */
#ifndef BOOST_LOG_INIT_TAIRAN_HPP
#define BOOST_LOG_INIT_TAIRAN_HPP

#include <iostream>
#include <boost/date_time/posix_time/posix_time.hpp>
#include <boost/log/support/date_time.hpp>
#include <boost/log/common.hpp>
#include <boost/log/expressions.hpp>
#include <boost/log/expressions/keyword.hpp>

#include <boost/log/attributes.hpp>
#include <boost/log/attributes/timer.hpp>
#include <boost/log/sources/logger.hpp>
#include <boost/log/sources/severity_logger.hpp>
#include <boost/log/sinks/sync_frontend.hpp>
#include <boost/log/sinks/text_file_backend.hpp>

#include <boost/log/utility/setup/file.hpp>
#include <boost/log/utility/setup/console.hpp>
#include <boost/log/utility/setup/common_attributes.hpp>

#include <boost/log/attributes/named_scope.hpp>

namespace logging = boost::log;
namespace attrs = boost::log::attributes;
namespace src = boost::log::sources;
namespace sinks = boost::log::sinks;
namespace expr = boost::log::expressions;
namespace keywords = boost::log::keywords;

enum SeverityLevel
{
    Log_Info,
    Log_Notice,
    Log_Debug,
    Log_Warning,
    Log_Error,
    Log_Fatal
};

// The formatting logic for the severity level
template< typename CharT, typename TraitsT >
inline std::basic_ostream< CharT, TraitsT >& operator<< (
    std::basic_ostream< CharT, TraitsT >& strm, SeverityLevel lvl)
{
    static const char* const str[] =
    {
        "Info",
        "Notice",
        "Debug",
        "Warning",
        "Error",
        "Fatal"
    };
    if (static_cast< std::size_t >(lvl) < (sizeof(str) / sizeof(*str)))
        strm << str[lvl];
    else
        strm << static_cast< int >(lvl);
    return strm;
}

BOOST_LOG_ATTRIBUTE_KEYWORD(log_severity, "Severity", SeverityLevel)
BOOST_LOG_ATTRIBUTE_KEYWORD(log_timestamp, "TimeStamp", boost::posix_time::ptime)
BOOST_LOG_ATTRIBUTE_KEYWORD(log_uptime, "Uptime", attrs::timer::value_type)
BOOST_LOG_ATTRIBUTE_KEYWORD(log_scope, "Scope", attrs::named_scope::value_type)

void g_InitLog();

#endif

实现：

#include "boost.log.init.hpp"

void g_InitLog()
{
    logging::formatter formatter=
        expr::stream
        <<"["<<expr::format_date_time(log_timestamp,"%H:%M:%S")
        <<"]"<<expr::if_(expr::has_attr(log_uptime))
        [
            expr::stream<<" ["<<format_date_time(log_uptime,"%O:%M:%S")<<"]"
        ]

    <<expr::if_(expr::has_attr(log_scope))
        [
            expr::stream<<"["<<expr::format_named_scope(log_scope,keywords::format = "%n")<<"]"
        ]
    <<"<"<<log_severity<<">"<<expr::message;

    logging::add_common_attributes();

    auto console_sink=logging::add_console_log();
    auto file_sink=logging::add_file_log
        (
        keywords::file_name="%Y-%m-%d_%N.log",      //文件名
        keywords::rotation_size=10*1024*1024,       //单个文件限制大小
        keywords::time_based_rotation=sinks::file::rotation_at_time_point(0,0,0)    //每天重建
        );

    file_sink->locked_backend()->set_file_collector(sinks::file::make_collector(
        keywords::target="logs",        //文件夹名
        keywords::max_size=50*1024*1024,    //文件夹所占最大空间
        keywords::min_free_space=100*1024*1024  //磁盘最小预留空间
        ));

    file_sink->set_filter(log_severity>=Log_Warning);   //日志级别过滤

    file_sink->locked_backend()->scan_for_files();

    console_sink->set_formatter(formatter);
    file_sink->set_formatter(formatter);
    file_sink->locked_backend()->auto_flush(true);

    logging::core::get()->add_global_attribute("Scope",attrs::named_scope());
    logging::core::get()->add_sink(console_sink);
    logging::core::get()->add_sink(file_sink);
}

使用：

调用g_initlog()初始化一次以后，在任意位置声明logger，使用宏BOOST_LOG_SEV(logger,SeverityLevel)<<"..."来写入日志即可。

标签：log,boost,sink,file,logger,include,Boost
From： https://www.cnblogs.com/RioTian/p/17647556.html

相关文章

  • 「Log」2023.8.21 小记
    序幕七点到校，管理整理博客。然后开始写博客，SAM的。学长开始讲题，2-SAT，还算好理解，写完博客过了下板子题。\(\color{royalblue}{P4782【模板】2-SAT问题}\)板子。\(\text{Link}\)间幕\(1\)吃饭，学长开始讲LCT。和SAM同样抽象的东西。好消息是代码跟SAM一样较为好写......
  • jvm参数与gclog
    http://ifeve.com/logging-stop-the-world-pauses-in-jvm/https://blog.csdn.net/ligeforrent/article/details/80834154......
  • telnet：Login incorrect
      问题描述：telnet服务端和客户端的telnet服务均正常，并且防火墙也是关闭的，但是根据提示输入用户名和密码后，还是无法连接连接到telnet客户端，如下图，提示：Loginincorrect（登录不正确），但是用户名和密码是完全正确的；解决办法：查看telnet客户端日志： cat/var/log/secure看到......
  • 【Logging 日志库】Cpp 日志库 boost::log 以及 glog 的对比
    日志能方便地诊断程序原因、统计程序运行数据，是大型软件系统必不可少的组件之一。本文将从设计上和功能上对比C++语言常见的两款日志库：boost::log和google-glog。设计boost::log的设计主要有日志器（Logger）、日志核心（Loggingcore）、Sink前后端（frontend,backend）组......
  • 网站LOGO
    网站LOGO<ahref="{$site[site_url]}"><imgsrc="{$site[site_logo]}"title="{$site[site_name]}"></a>版权声明{$site[site_copyright]}网站备案号备案号：<ahref="http://beian.miit.gov.cn/"target="_blank&......
  • Java-logback.xml配置
    <?xmlversion="1.0"encoding="UTF-8"?><configurationdebug="false"><!--定义日志文件的存储地址勿在LogBack的配置中使用相对路径--><propertyname="LOG_HOME"value="\logs"/><!--控制台输出-......
  • 4.5 C++ Boost 文件目录操作库
    Boost库是一个由C/C++语言的开发者创建并更新维护的开源类库，其提供了许多功能强大的程序库和工具，用于开发高质量、可移植、高效的C应用程序。Boost库可以作为标准C库的后备，通常被称为准标准库，是C标准化进程的重要开发引擎之一。使用Boost库可以加速C应用程序的开发过程，提高代码质......
  • 4.7 C++ Boost 多线程并发库
    Boost库是一个由C/C++语言的开发者创建并更新维护的开源类库，其提供了许多功能强大的程序库和工具，用于开发高质量、可移植、高效的C应用程序。Boost库可以作为标准C库的后备，通常被称为准标准库，是C标准化进程的重要开发引擎之一。使用Boost库可以加速C应用程序的开发过程，提高代码质......
  • 写Verilog通用模块的小技巧----持续更新
    在编写代码为了能够方便移植或者说为了一劳永逸，往往会考虑把模块代码写得更加的通用。比如可以进行传参配置，这里主要是通过位宽传参。笔者写过不少的代码，觉得写通用模块代码需要思考挺长的时间去处理数据赋值之类的，需要总结出公式才能使代码通用，为了方便查找，这里就总结下笔者......
  • weblogic patch
    FusionMiddlewareCriticalPatchUpdate(CPU)ProgramApril2023PatchAvailabilityDocument(PAD)(DocID2936090.2) CriticalPatchUpdate(CPU)PatchAdvisorforOracleFusionMiddleware-UpdatedforJuly2023(DocID2806740.2) CriticalPatchUpda......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99