C++ 日志库 spdlog 使用教程

news/2025/1/7 21:41:13/

Spdlog是一个快速、异步、线程安全的C++日志库，他可以方便地记录应用程序的运行状态，并提供多种输出格式。官网：https://github.com/gabime/spdlog

安装教程可以参考：https://blog.csdn.net/Harrytsz/article/details/144887297

Spdlog的优点：

  • 只包含头文件
  • 速度很快
  • 无需依赖第三方库
  • 支持跨平台
  • 支持多线程—线程安全
  • 可对日志文件进行循环输出
  • 可每日生成日志文件
  • 可支持控制台日志输出
  • 可选的异步输出
  • 可定义日志格式

1、日志级别

trace = SPDLOG_LEVEL_TRACE // 最低级（用来记录代码执行轨迹）
debug = SPDLOG_LEVEL_DEBUG //      （用来记录debug信息）
info = SPDLOG_LEVEL_INFO   // 在上面的测试例子中用过
warn = SPDLOG_LEVEL_WARN
err = SPDLOG_LEVEL_ERROR
critical = SPDLOG_LEVEL_CRITICAL
off = SPDLOG_LEVEL_OFF     // 最高级

2、控制台打印日志

方式一，最简单的使用方式，将日志输出到控制台。

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void stdout_easy()
{// 根据参数，在内部创建了一个名为 "console" 的 logger，返回 logger 的智能指针。auto console = spdlog::stdout_color_mt("console");// 通过智能指针调用 logger 对象的函数。console->info("hello world");
}
int main()
{stdout_easy();return 0;
}

输出结果：
在这里插入图片描述

方式二，

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void stdout_example() {// create a color multi-threaded logger// spdlog::stdout_color_mt("console")函数创建一个名字为console的console logger，// 把这个 logger 注册到 spdlog 的全局注册表中，并且返回指向这个 logger 的指针（shared_ptr）auto console_stdout = spdlog::stdout_color_mt("console");// 如果我们不知道上方创建函数返回的指针，我们也可以直接通过 logger 名称来获取对应 logger // 通过 get 来获取已经创建好的 logger，获取方式通过指针名，同时使用 info 函数输出日志内容spdlog::get("console")->info("loggers can be retrieved from a global registry using the spdlog::get(logger_name)");
}int main() {stdout_example();return 0;
}

输出结果：
在这里插入图片描述

3、保存日志文件

下面的案例将日志记录保存到文件中，以便于长久保存。basic_logger_mt 只是 spdlog 中封装的其中一个日志记录器，还有很多其他的记录器。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/basic_file_sink.h>int main() {// 创建一个名为 basic_logger 的日志记录器，并且返回指针。// mt 表示多线程,意味着多个线程中使用同一个日志记录器。// 需要注意的是在文件内添加数据是通过追加的形式进行的，并且如果没有创建文件会自动创建文件。auto basic_logger = spdlog::basic_logger_mt("basic_logger", "./logs/basic_log.txt");for (int i = 0; i < 10000; i++) {basic_logger->info("Test file logger{}", i);}return 0;
}

在这里插入图片描述

4、自定义日志记录器

我们根据以上的学习之后，大体了解了其中的运行机制，所以我们就可以不使用他封装的日志记录器，而是使用他内部的 logger 对象封装适合自己的日志记录器。

需要注意的是，所谓的不同的日志记录器其实就是不同的 logger 对象，那么用什么来区分不同的 logger 对象呢，就是用创建logger对象时传入的参数 sink 对象，这个sink对象标记着不同的类型，把他作为参数 logger 会根据 sink 对象类型的不同创建不同的日志记录器。

这种方式有很大的用途，比如我们可以创建一个日志记录器，但是里边有多个类型的 sink，从而可以一个 logger 能够实现多种效果。

#include<iostream>
#include<spdlog/spdlog.h>
//#include <spdlog/sinks/stdout_sinks.h>
#include <spdlog/sinks/stdout_color_sinks.h>void make_console_spdlog() {/*auto console_level = std::make_shared<spdlog::sinks::stdout_sink_mt>();*/    // 黑白日志auto console_level = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();  // 彩色日志auto console = std::make_shared<spdlog::logger>("console", console_level);console->info("hello world");
}int main() {make_console_spdlog();return 0;
}

输出结果：
在这里插入图片描述

注意：通过手动创建的日志记录器是无法通过名字在 spdlog 中进行查找的，因为他并没有注册到 spdlog 的全局注册表。

void make_console_spdlog() {auto console_level = std::make_shared<spdlog::sinks::stdout_sink_mt>();auto console = std::make_shared<spdlog::logger>("console", console_level);// 直接使用这种方式去获取日志记录器发生错误spdlog::get("console")->info("hello world!");
}

所以在创建日志记录器完成后，要将其注册到spdlog的全局注册表中。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void make_console_spdlog() {auto console_level = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();auto console = std::make_shared<spdlog::logger>("console", console_level);// 将创建的日志记录器注册到全局注册表中spdlog::register_logger(console);spdlog::get("console")->info("hello world!");
}int main() {make_console_spdlog();return 0;
}

5、多记录器共享文件

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/basic_file_sink.h>void multi_file_write()
{// 创建filesink，以便多个日志共享器共享。auto filesink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("./logs/multilogger.txt");// 创建两个日志记录器来进行测试auto onelogger = std::make_shared<spdlog::logger>("onelogger", filesink);auto twologger = std::make_shared<spdlog::logger>("twologger", filesink);// 注册进spdlog的全局注册表spdlog::register_logger(onelogger);spdlog::register_logger(twologger);for (int i = 0; i < 100; i++) {onelogger->info("onelogger write:{}", i);twologger->info("twologger write:{}", i);}
}int main() {multi_file_write();return 0;
}

在这里插入图片描述

6、日志分割

在我们的应用程序有很多日志需要记录时，每个日志文件就会变得非常大，这样就会影响应用程序的性能以及稳定性。所以为了解决这个问题，可以使用Spdlog的日志分割功能。

rotating log 滚动日志，当日志文件超出规定大小时，会删除当前日志文件中所有内容，重新开始写入

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/rotating_file_sink.h>void rotaing_file() {// 首先定义要使用分割文件的大小和数量int max_size = 1048576 * 5;int file_size = 3;// 创建 rotaing_logger_mt 日志记录器auto rotaing_file = spdlog::rotating_logger_mt("rotaing_file", "./logs/rotaingLogger.txt", max_size, file_size);for (int i = 0; i < 100000; i++) {rotaing_file->info("rotaing file:{}", i);}
}int main() {rotaing_file();return 0;
}

7、定时日志

Spdlog还可以实现定时创建文件存储日志的功能。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/daily_file_sink.h>void daily_log() {// 创建daily_log日志// 参数介绍 1日志记录器名称 2文件名 3时 4分auto daily_log = spdlog::daily_logger_mt("daily_log", "./logs/daily_log.txt", 16, 18);for (int i = 0; i < 100000; i++) {daily_log->info("daily log print {}", i);}
}int main() {daily_log();return 0;
}

8、记录器包含多个 sink

#include<iostream>
#include<spdlog/spdlog.h>
#include<spdlog/sinks/stdout_color_sinks.h>
#include<spdlog/sinks/basic_file_sink.h>void multi_sink() {// 创建两个sink，一个用于控制台输出，一个用于文件输出auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("./logs/multi_sink.txt");// 设置两者输出等级console_sink->set_level(spdlog::level::info);file_sink->set_level(spdlog::level::debug);// 将两种不同的sink放到一个日志输出器中auto multi_sink = std::make_shared<spdlog::logger>("multi_sink", spdlog::sinks_init_list({ console_sink, file_sink }));multi_sink->set_level(spdlog::level::debug);// 输出不同等级日志测试multi_sink->info("hello world info");multi_sink->debug("hello world debug");
}int main() {multi_sink();return 0;
}

9、其他介绍

通过上面的学习，我们学会了 spdlog 其函数的基本使用方式，下面对 spdlog 中常用的一些函数和类进行介绍。

  • level_enum：日志等级枚举，包括trace、info、debug、warn、err、critical、off、n_levels。
  • sink：日志记录槽，进行底层操作（比如格式化内容，输出内容到控制台/文件）的类。spdlog自带的几种sinks已经能满足日常需求，也可以派生其基类设计新的 sink 以满足特殊的需求。sink类主要使用的函数包括：
    • set_pattern(const std::string&)：设置日志输出格式。
    • set_level(level_enum)：设置日志输出的最低等级。
    • log(log_msg)：由logger自动调用，外部不会主动调用。
  • logger：日志记录器，被顶层调用来输出日志的类。一个logger对象中存储有多个sink，当调用logger的日志输出函数时，logger会调用自身存储的所有sink对象的log(log_msg)函数进行输出。与自身的sink对应，spdlog也自带了几种logger。logger类主要使用的函数包括：
    • set_pattern(const std::string&)：设置logger包括的所有sink的日志输出内容格式。
    • set_level(level_enum)：设置logger日志输出最低等级，如果logger包含的sink没有设置日志等级的话，则会为其设置日志等级。
    • log(level_enum level, log_msg content)：按照level等级进行输出content，logger其中日志输出最低等级小于或等于level的sink会执行输出操作。
    • info(content, arg1, arg2…)：按照trace等级进行输出，输出内容由content与后面的采纳数格式化组成。荣磊的函数还包括debug/trace/warn…。
  • st/mt：对象版本，spdlog 中 logger 对象和 sink 对象都有两种版本，一种是以 st 结尾的单线程版本，以及以 mt 结尾的多线程版本。
    • st：单线程版本，不用加锁，效率更高。
    • mt：多线程版本，用于多线程程序是线程安全的。

http://www.ppmy.cn/news/1561059.html

相关文章

自动化删除work32挖矿脚本

自动化删除work32挖矿脚本

work32 是一个挖矿病毒&#xff0c;会进入到linux服务器中挖矿&#xff0c;导致你的服务器很卡&#xff0c;删了又有&#xff0c;根本停不掉&#xff0c;那我们自动化删 #!/bin/bash# 目标进程关键词 PROCESS_NAME"work32"while true; do# 检查是否存在目标进程pid$…
阅读更多...
MySQL数据表设计 系统权限表设计 权限、角色、用户表设计

MySQL数据表设计 系统权限表设计 权限、角色、用户表设计

数据库 创建 CREATE DATABASE my_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; 修改 ALTER DATABASE my_database CHARACTER SETutf8mb4 COLLATEutf8mb4_unicode_ci; 字符集&#xff1a;utf8和utf8mb4&#xff0c;推荐使用&#xff1a;utf8mb4 utf8&…
阅读更多...
ceph文件系统

ceph文件系统

ceph文件系统 ceph基础知识ceph系统的核心原理和组件1. 架构和组件1.1 Ceph Monitor (MON)1.2 Ceph OSD (Object Storage Daemon)1.3 Ceph MDS (Metadata Server)1.4 Ceph Client 2. 数据存储与分布2.1 CRUSH 算法2.2 数据副本与容错 3. 数据一致性4. pg和存储池与osd之间的关系…
阅读更多...
掌控ctf-2月赛

掌控ctf-2月赛

没事干 随便刷刷题 1伪协议读取系统进程 源码 <?php highlight_file(__FILE__); require_once flag.php; if(isset($_GET[file])) {require_once $_GET[file]; } 伪协议读取flag.php&#xff0c;/proc/self指向当前进程的 exp ?filephp://filter/readconvert.base64…
阅读更多...
Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码 【AI辅助开发系列】

Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码 【AI辅助开发系列】

&#x1f380;&#x1f380;&#x1f380;【AI辅助编程系列】&#x1f380;&#x1f380;&#x1f380; Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码Visual Studio 安装和管理 GitHub CopilotVisual Studio 使用 GitHub Copilot 扩展Visual Studio 使用 GitHu…
阅读更多...
Django Swagger文档库drf-spectacular

Django Swagger文档库drf-spectacular

一、概述 drf-spectacular 是一个为 Django REST Framework (DRF) 设计的 OpenAPI 3.0 和 3.1 规范的生成器。它旨在提供既理智又灵活的方式来创建 API 文档&#xff0c;主要实现以下三个目标&#xff1a; 从 DRF 中提取尽可能多的 schema 信息提供灵活性&#xff0c;使 schema…
阅读更多...
2025年贵州省职业院校技能大赛信息安全管理与评估赛项规程

2025年贵州省职业院校技能大赛信息安全管理与评估赛项规程

贵州省职业院校技能大赛赛项规程 赛项名称&#xff1a; 信息安全管理与评估 英文名称&#xff1a; Information Security Management and Evaluation 赛项组别&#xff1a; 高职组 赛项编号&#xff1a; GZ032 1 2 一、赛项信息 赛项类别 囚每年赛 □隔年赛&#xff08;□单数年…
阅读更多...
Dockerfile进行详细的介绍

Dockerfile进行详细的介绍

Dockerfile 是用于定义 Docker 镜像构建过程的文本文件&#xff0c;它包含了一系列的命令和指令&#xff0c;这些命令告诉 Docker 如何构建一个镜像。Docker 镜像是应用程序和所有依赖项的打包&#xff0c;其中包括操作系统环境、安装的依赖包以及应用本身。 通过 Dockerfile&…
阅读更多...
最新文章

Copyright @ 2022~2023