繼續上一篇，example.cpp解析。1、set_pattern 自定義日誌格式官方參考：https://github.com/gabime/spdlog/wiki/3.-Custom-formatting可以為所有的log制定格式，也可以為指定的log制定格式，註意下麵代碼中rotating_l... ...
繼續上一篇，example.cpp解析。
1、set_pattern 自定義日誌格式
官方參考：https://github.com/gabime/spdlog/wiki/3.-Custom-formatting
可以為所有的log制定格式，也可以為指定的log制定格式，註意下麵代碼中rotating_logger為指針變數。
auto rotating_logger = spd::rotating_logger_mt("some_logger_name", "logs/rotating.txt", 256, 2);
// Customize msg format for all messages spd::set_pattern("*** [%H:%M:%S %z] [thread %t] %v ***"); rotating_logger->info("This is another message with custom format"); //Customize msg format for a specific logger object: rotating_logger->set_pattern("[%H:%M:%S %f] [thread %t] %v ***");
詳細的格式說明在github上有，在此截圖如下：
2、set_level 設置日誌級別
低於設置級別的日誌將不會被輸出。各level排序，數值越大級別越高：
// Runtime log levels spd::set_level(spd::level::info); //Set global log level to info console->debug("This message should not be displayed!"); console->set_level(spd::level::debug); // Set specific logger's log level console->debug("This message should be displayed..");
第一行日誌debug級別低於設定的級別info，在level為info時不會被輸出。
第二行日誌debug級別與設定的級別相同，所以可以顯示出來。
typedef enum { trace = 0, debug = 1, info = 2, warn = 3, err = 4, critical = 5, off = 6 } level_enum;
3、編譯階段修改日誌輸出級別 SPDLOG_TRACE 和 SPDLOG_DEBUG
官方參考：https://github.com/gabime/spdlog/wiki/8.-Tweaking
當定義了巨集定義 SPDLOG_TRACE_ON 時，可以用SPDLOG_TRACE語句輸出trace級別的log，SPDLOG_DEBUG_ON也是同理。
#define SPDLOG_TRACE_ON #define SPDLOG_DEBUG_ON
// Compile time log levels // define SPDLOG_DEBUG_ON or SPDLOG_TRACE_ON SPDLOG_TRACE(console, "Enabled only #ifdef SPDLOG_TRACE_ON..{} ,{}", 1, 3.23); SPDLOG_DEBUG(console, "Enabled only #ifdef SPDLOG_DEBUG_ON.. {} ,{}", 1, 3.23);
需要註意的是，如果不使用set_level命令設置log的輸出級別，預設級別就是info級別，此時即使定義了這兩個巨集，debug和trace信息也不會輸出。所以使用時需要先用set_level把級別設為trace才可以。
console->set_level(spd::level::trace); // Set specific logger's log level // Compile time log levels // define SPDLOG_DEBUG_ON or SPDLOG_TRACE_ON SPDLOG_TRACE(console, "Enabled only #ifdef SPDLOG_TRACE_ON..{} ,{}", 1, 3.23); SPDLOG_DEBUG(console, "Enabled only #ifdef SPDLOG_DEBUG_ON.. {} ,{}", 1, 3.23);
以下是輸出結果：
註意trace和debug的輸出不太一樣，打開spdlog.h，查看SPDLOG_TRACE的定義，可以發現trace中還輸出了文件的位置（“__FILE__”）。
#ifdef SPDLOG_TRACE_ON # define SPDLOG_STR_H(x) #x # define SPDLOG_STR_HELPER(x) SPDLOG_STR_H(x) # ifdef _MSC_VER # define SPDLOG_TRACE(logger, ...) logger->trace("[ " __FILE__ "(" SPDLOG_STR_HELPER(__LINE__) ") ] " __VA_ARGS__) # else # define SPDLOG_TRACE(logger, ...) logger->trace("[ " __FILE__ ":" SPDLOG_STR_HELPER(__LINE__) " ] " __VA_ARGS__) # endif #else # define SPDLOG_TRACE(logger, ...) (void)0 #endif #ifdef SPDLOG_DEBUG_ON # define SPDLOG_DEBUG(logger, ...) logger->debug(__VA_ARGS__) #else # define SPDLOG_DEBUG(logger, ...) (void)0 #endif
4、同步和非同步設置 Asynchronous logging
官方說明：https://github.com/gabime/spdlog/wiki/6.-Asynchronous-logging
預設情況下是不開啟非同步模式的，開啟非同步模式方式如下：
size_t q_size = 4096; //queue size must be power of 2 spdlog::set_async_mode(q_size);
隊列大小：
隊列占用的記憶體 = 設置的隊列大小 * slot的大小， 64位系統下slot大小為104位元組。由此可根據系統的log輸出總量來確定隊列大小。
隊列機制：
非同步模式下，所有輸出的日誌將先存入隊列，再由工作者線程從隊列中取出日誌並輸出。當隊列存滿時，需要根據設置好的隊列存滿策略來處置新來的日誌（阻塞消息或者丟棄消息）。如果工作者線程中拋出了異常，向隊列寫入下一條日誌時異常會再次拋出，可以在寫入隊列時捕捉工作者線程的異常。
隊列存滿時（Full queue policy）兩種應對方式：
（1）阻塞新來的日誌，直到隊列中有剩餘空間。這是預設的處理方式。
（2）丟棄新來的日誌。如下：
spdlog::set_async_mode(q_size, spdlog::async_overflow_policy::discard_log_msg)
兩種應對方式如下：
// Async overflow policy - block by default. // enum class async_overflow_policy { block_retry, // Block / yield / sleep until message can be enqueued discard_log_msg // Discard the message it enqueue fails };
5、處理spdlog的異常 set_error_handler
官方說明：https://github.com/gabime/spdlog/wiki/Error-handling
當輸出日誌時發生異常時，spdlog會向std::err 列印一條語句，為了避免輸出的異常語句刷屏，列印頻率被限制在每分鐘一條。
下麵函數執行時，由於最後一條輸出log的語句中四個參數只給了一個，所以spdlog調用了異常處理函數，輸出異常。
void err_handler_example() { //can be set globaly or per logger(logger->set_error_handler(..)) spdlog::set_error_handler([](const std::string& msg) { std::cerr << "my err handler: " << msg << std::endl; }); spd::get("console")->info("some invalid message to trigger an error {}{}{}{}", 3); }
6、apply_all 使所有的logger同時輸出
所有註冊過的logger都會輸出End of example 這句話，代表程式結束。
// Apply a function on all registered loggers spd::apply_all([&](std::shared_ptr<spdlog::logger> l) { l->info("End of example."); });
7、drop -- 釋放logger
在程式結束時，應該調用drop_all() 釋放所有logger。
There is a bug in VS runtime that cause the application dead lock when it exits. If you use async logging, please make sure to call spdlog::drop_all() before main() exit. If some loggers are not in the registry, those should be released manually as well. stackoverflow: std::thread join hangs if called after main exits when using vs2012 rc
// Release and close all loggers spdlog::drop_all();
或者單獨drop某個logger
spd::drop("console"); spd::drop("basic_logger");
