EasyLogger 是一款超轻量级(ROM<1.6K, RAM<0.3K)、高性能的 C/C++ 日志库，非常适合对资源敏感的软件项目，例如： IoT 产品、可穿戴设备、智能家居等等。相比 log4c、zlog 这些知名的 C/C++ 日志库， EasyLogger 的功能更加简单，提供给用户的接口更少，但上手会很快，更多实用功能支持以插件形式进行动态扩展。

主要特性

支持用户自定义输出方式（例如：终端、文件、数据库、串口、485、Flash…）；日志内容可包含级别、时间戳、线程信息、进程信息等；日志输出被设计为线程安全的方式，并支持 异步输出 及 缓冲输出 模式；支持多种操作系统（RT-Thread、UCOS、Linux、Windows…），也支持裸机平台；日志支持 RAW格式 ；支持按 标签 、 级别 、 关键词 进行动态过滤；各级别日志支持不同颜色显示扩展性强，支持以插件形式扩展新功能。

使用

参数配置

EasyLogger 拥有过滤方式、输出格式、输出开关这些属性。

过滤方式支持按照标签、级别、关键词进行过滤；可以动态的开启/关闭日志的输出；可设定动态和静态的输出级别（静态：一级开关，通过宏定义；动态：二级开关，通过API接口）。

输出级别

参考 Android Logcat ，级别最高为 0(Assert) ，最低为 5(Verbose) 。

0.[A]：断言(Assert)1.[E]：错误(Error)2.[W]：警告(Warn)3.[I]：信息(Info)4.[D]：调试(Debug)5.[V]：详细(Verbose)

输出缤纷多彩的日志

各个级别日志默认颜色效果如下。用户也可以根据自己的喜好，在 elog_cfg.h 对各个级别日志的颜色及字体风格进行单独设置。

输出过滤

支持按照 级别、标签及关键词 进行过滤。日志内容较多时，使用过滤功能可以更快定位日志，保证日志的可读性。更多的过滤功能设置方法及细节请阅读\docs\zh\api\kernel.md文档

输出格式

输出格式支持：级别、时间、标签、进程信息、线程信息、文件路径、行号、方法名。每种优先级别可以独立设置输出格式。

注：默认为 RAW格式，RAW格式日志不支持标签过滤

输出方式

通过用户的移植，可以支持任何一种输出方式。只不过对于某种输出方式可能引入的新功能，需要通过插件实现，例如：文件转存，检索Flash日志等等。后期会有更多的插件开源出来。下面简单对比下部分输出方式使用场景：

终端：方便用户动态查看，不具有存储功能；文件与Flash：都具有存储功能，用户可以查看历史日志。但是文件方式需要文件系统的支持，而Flash方式更加适合应用在无文件系统的小型嵌入式设备中。

Demo

下图为在终端中输入命令来控制日志的输出及过滤器的设置，更加直观的展示了 EasyLogger 核心功能。

精选文章分类