C++ Boost log日志库超详细讲解

什么是C++ Boost log日志库？

C++ Boost log是一个高度灵活和可定制的C++日志库，它提供了一系列便利的接口和功能，帮助我们实现日志的收集、保存、查询和分析等操作。同时，它还提供了多种日志输出格式和输出目标，例如标准输出、文件、syslog等。

安装C++ Boost log日志库

在使用C++ Boost log日志库之前，需要先安装Boost库和Boost Log库。这里以Ubuntu操作系统为例，演示安装步骤。

sudo apt-get update
sudo apt-get install libboost-dev libboost-log-dev

C++ Boost log日志库基本用法

记录日志

在使用C++ Boost log日志库时，需要先创建一个logger对象，通过该对象来记录日志并输出。在实际应用中，我们一般会创建多个logger对象，每个logger对象可能用于统计不同的数据或日志记录。

#include <boost/log/trivial.hpp>
#include <boost/log/sources/logger.hpp>
#include <boost/log/sources/record_ostream.hpp>

using namespace boost::log::trivial;
using namespace boost::log::sources;

int main() {
    logger lg;
    BOOST_LOG(lg) << "Hello, Boost log!";
    return 0;
}

在上面的示例中，创建了一个logger对象lg，并使用BOOST_LOG(lg) << "Hello, Boost log!";输出日志信息。使用BOOST_LOG(loggerName)函数可以指定使用哪个logger对象记录日志。

日志级别

C++ Boost log日志库提供了多个不同的日志级别，用于指定日志的重要程度。默认情况下，只有级别大于等于warning的日志才会被输出。

BOOST_LOG(lg) << "A trace severity message, typically disabled.";
BOOST_LOG(lg) << "A debug severity message.";
BOOST_LOG(lg) << "An info severity message.";
BOOST_LOG(warning) << "A warning severity message.";
BOOST_LOG(error) << "An error severity message.";
BOOST_LOG(fatal) << "A fatal severity message.";

在上面的示例中，输出了6条不同级别的日志信息。在日志输出时，可以使用BOOST_LOG_SEV(loggerName, severityLevel)函数指定日志级别。

日志格式

C++ Boost log日志库提供了多种输出格式，用于设置日志的显示格式。常用的日志输出格式有text、xml、json等。

#include <boost/log/expressions.hpp>

logging::add_file_log
(
    logging::keywords::file_name = "sample_%N.log",
    logging::keywords::format = (
        boost::log::expressions::stream
            << "[" << boost::log::expressions::format_date_time< boost::posix_time::ptime >("TimeStamp", "%Y-%m-%d %H:%M:%S.%f") << "]"
            << "[" << boost::log::trivial::severity << "]"
            << " " << boost::log::expressions::smessage
    )
);

上面的代码使用add_file_log函数设置了日志的输出格式，同时还将日志输出到了文件中。在日志输出格式中，使用boost::log::expressions::stream来设置输出格式，使用boost::log::trivial::severity来指示日志级别。

日志输出目标

C++ Boost log日志库支持多种输出方式，例如输出到标准输出、输出到文件、输出到syslog等。下面是一个将日志输出到文件的示例：

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

boost::log::add_file_log(
    boost::log::keywords::file_name = "sample.log", // 日志文件名
    boost::log::keywords::rotation_size = 10 * 1024 * 1024, // 滚动大小为10MB
    boost::log::keywords::max_size = 100 * 1024 * 1024, // 日志文件最大为100MB
    boost::log::keywords::format = (
        boost::log::expressions::stream
            << "[" << boost::log::expressions::format_date_time< boost::posix_time::ptime >("TimeStamp", "%Y-%m-%d %H:%M:%S.%f") << "]"
            << "[" << boost::log::trivial::severity << "]"
            << " " << boost::log::expressions::smessage
    )
);

在上面的代码中，使用boost::log::add_file_log函数将日志输出到了文件中，并设置了文件名、滚动大小、最大日志文件大小、输出格式等参数。

示例演示

示例1：记录日志并输出到文件中

#include <boost/log/trivial.hpp>
#include <boost/log/sources/logger.hpp>
#include <boost/log/sources/record_ostream.hpp>
#include <boost/log/utility/setup/file.hpp>

using namespace boost::log::trivial;
using namespace boost::log::sources;

int main() {
    boost::log::add_file_log(
        boost::log::keywords::file_name = "example1.log",
        boost::log::keywords::rotation_size = 10 * 1024 * 1024,
        boost::log::keywords::max_size = 100 * 1024 * 1024,
        boost::log::keywords::format = (
            boost::log::expressions::stream
                << "[" << boost::log::expressions::format_date_time< boost::posix_time::ptime >("TimeStamp", "%Y-%m-%d %H:%M:%S.%f") << "]"
                << "[" << boost::log::trivial::severity << "]"
                << " " << boost::log::expressions::smessage
        )
    );
    logger lg;
    BOOST_LOG(lg) << "Hello, Boost log!";
    return 0;
}

在该示例中，使用boost::log::add_file_log函数将日志输出到了名为"example1.log"的文件中，并设置滚动大小和最大文件大小等参数。记录了一条简单的日志信息并输出到文件中。

示例2：不同的logger对象记录不同的日志

#include <boost/log/trivial.hpp>
#include <boost/log/sources/logger.hpp>
#include <boost/log/sources/record_ostream.hpp>
#include <boost/log/utility/setup/file.hpp>

using namespace boost::log::trivial;
using namespace boost::log::sources;

int main() {
    boost::log::add_file_log(
        boost::log::keywords::file_name = "example2.log",
        boost::log::keywords::rotation_size = 10 * 1024 * 1024,
        boost::log::keywords::max_size = 100 * 1024 * 1024,
        boost::log::keywords::format = (
            boost::log::expressions::stream
                << "[" << boost::log::expressions::format_date_time< boost::posix_time::ptime >("TimeStamp", "%Y-%m-%d %H:%M:%S.%f") << "]"
                << "[" << boost::log::trivial::severity << "]"
                << " " << boost::log::expressions::smessage
        )
    );
    logger lg1, lg2;
    BOOST_LOG(lg1) << "Hello, Boost log1!";
    BOOST_LOG(lg2) << "Hello, Boost log2!";
    return 0;
}

在该示例中，创建了2个不同的logger对象，分别用于记录不同的日志信息。使用BOOST_LOG(loggerName)函数指定使用哪个logger对象记录日志。同时，将日志输出到名为"example2.log"的文件中。