【升级】C/C++ 日志库 EasyLogger 新增彩色日志、异步输出等

sunnydragon · 发表于 2016-11-14 20:16:57

本帖最后由 sunnydragon 于 2016-11-14 21:44 编辑

EasyLogger 是一款超轻量级(ROM<1.6K, RAM<0.3K)、高性能的 C/C++ 日志库，非常适合对资源敏感的软件项目，例如： IoT 产品、可穿戴设备、智能家居等等。 EasyLogger 功能简单，上手速度快，更多实用功能支持以插件形式进行动态扩展。

主要特性

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

本次更新版本号 V1.11.13，主要发布以下重要功能：

1、新增彩色日志
所有级别日志可独立设置颜色，错误信息更加明显，日志更加赏心悦目，进一步提升调试效率。详细使用方法，请参照说明文档（点击查看）。Linux Demo 里已经默认开启了此功能，大致效果如下，欢迎试用

点击查看在 xshell 上显示彩色串口日志的配置方法

2、新增异步输出模式（非阻塞输出模式）
之前的版本默认为阻塞的同步输出模式，即用户线程输出日志时，日志必须完全输出到输出介质（串口、网络、文件等）上，输出过程才会退回。
这样会影响应用软件执行时间及执行效率。开启异步输出模式后，后台有专门的日志线程负责完成日志输出功能，应用程序输出日志时，底层只将日志拷贝至缓冲区后，随即退出日志输出方法。

异步输出默认使用 POSIX pthread 实现，对于 Windows 、Liunx 、RT-Thread 及其他支持 POSIX pthread 的用户，只需开启异步输出相关配置，即可开启此功能。
对于缺少 pthread 支持的平台，例如：ucos ，也可以参考 elog_async.c 中关于异步输出线程的实现方式，自己动手实现。
PS：Linux Demo 中已开启 pthread 异步输出模式，RT-Thread Demo 已使用其线程相关 API 实现异步输出模式。

3、新增缓冲输出模式
开启缓冲输出模式后，如果缓冲区不满，用户线程在进行日志输出时，无需等待日志彻底输出完成，即可直接返回。
但当日志缓冲区满以后，将会占用当前用户线程，自动将缓冲区中的日志全部输出干净。
同时用户也可以在其他非用户线程，通过定时等机制使用 `void elog_flush(void)` 将缓冲区中的日志输出干净。

下载方式
最新版请关注 GitHub：https://github.com/armink/EasyLogger
本坛下载：

浪客剑心绯村 · 发表于 2016-11-14 20:23:45

占一楼，顶！！！

fraser · 发表于 2016-11-14 20:55:18

占二楼，顶！！！

ndt2000 · 发表于 2016-11-14 21:21:42

占三楼，顶!!!

霸气侧漏 · 发表于 2016-11-14 21:33:32

占四楼，顶!!!

落叶知秋 · 发表于 2016-11-14 21:48:05

占五楼，恭喜楼主又升级了这个开源项目。

love_zjb · 发表于 2016-11-14 21:51:05

显示颜色是怎么实现的？

honami520 · 发表于 2016-11-15 00:51:30

好牛逼的东西，这个在资源丰富的芯片下面，可以直接使用；

myxiaonia · 发表于 2016-11-15 08:08:14

闪存库现在可以作为数据保存组件使用了吗，就是频繁的保存很多用户参数

security · 发表于 2016-11-15 08:46:42

本帖最后由 security 于 2016-11-15 09:01 编辑

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的？

我猜是基于 ANSI/VT100 之类的虚拟终端控制协议。
我自己的 logger 是这么实现的。

dreambox · 发表于 2016-11-15 10:09:27

不错，谢谢楼主

gujiamao_love · 发表于 2016-11-15 10:53:49

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的？

你搜索下\033，我在putty下都是这么用的

sunnydragon · 发表于 2016-11-15 20:29:06

love_zjb 发表于 2016-11-14 21:51
显示颜色是怎么实现的？

这个参照 ANSI 的一个标准，详见维基百科：https://en.wikipedia.org/wiki/ANSI_escape_code

sunnydragon · 发表于 2016-11-15 20:31:15

honami520 发表于 2016-11-15 00:51
好牛逼的东西，这个在资源丰富的芯片下面，可以直接使用；

不用很丰富的资源，支持嵌入式操作系统的产品，支持这些功能会更加轻松。

sunnydragon · 发表于 2016-11-15 20:33:29

myxiaonia 发表于 2016-11-15 08:08
闪存库现在可以作为数据保存组件使用了吗，就是频繁的保存很多用户参数

没太听明白你说的这个“数据保存组件”具体指的什么？

sunnydragon · 发表于 2016-11-15 20:34:47

security 发表于 2016-11-15 08:46
我猜是基于 ANSI/VT100 之类的虚拟终端控制协议。
我自己的 logger 是这么实现的。 ...

是的，这个是 ANSI 的一个标准。

myxiaonia · 发表于 2016-11-16 07:17:52

sunnydragon 发表于 2016-11-15 20:33
没太听明白你说的这个“数据保存组件”具体指的什么？

恩恩，就是类似于把闪存当作eeprom来用

hanzo852 · 发表于 2016-11-16 08:44:19

编译失败
static const char *level_output_info[] = {
      [ELOG_LVL_ASSERT]  = "A/",
      [ELOG_LVL_ERROR] = "E/",
      [ELOG_LVL_WARN] = "W/",
      [ELOG_LVL_INFO] = "I/",
      [ELOG_LVL_DEBUG] = "D/",
      [ELOG_LVL_VERBOSE] = "V/",
};
/* color output info */
static const char *color_output_info[] = {
      [ELOG_LVL_ASSERT]  = ELOG_COLOR_ASSERT,
      [ELOG_LVL_ERROR] = ELOG_COLOR_ERROR,
      [ELOG_LVL_WARN] = ELOG_COLOR_WARN,
      [ELOG_LVL_INFO] = ELOG_COLOR_INFO,
      [ELOG_LVL_DEBUG] = ELOG_COLOR_DEBUG,
      [ELOG_LVL_VERBOSE] = ELOG_COLOR_VERBOSE,
};

///////////////
..\..\..\..\easylogger\src\elog.c(116): error:  #29: expected an expression

security · 发表于 2016-11-16 08:59:17

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
[ELOG_LVL_ASSERT] = "A/",

这种问题，我猜原因：多数是没打开 C99 编译选项，
请打开对 C99 的支持，再试下。

小溪 · 发表于 2016-11-16 09:48:42

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
[ELOG_LVL_ASSERT] = "A/",

打开工程options for target's stm32f103xE,在 Misc Control一栏空白处添加--c99,再重新编译一下

sunnydragon · 发表于 2016-11-16 18:53:53

hanzo852 发表于 2016-11-16 08:44
编译失败
static const char *level_output_info[] = {
[ELOG_LVL_ASSERT] = "A/",

刚刚在 GitHub 上更新了：https://github.com/armink/EasyLogger ，增强了对 Keil4 的兼容性。

默认用 keil5 打开编译是不会有问题，估计你是用的 keil4 吧。

Keil 5 有个 C99 单选框（如下图），但 Keil4 没有。所以 Keil4 需要在 Misc Controls 里增加： --C99 选项

sunnydragon · 发表于 2016-11-16 18:56:52

myxiaonia 发表于 2016-11-16 07:17
恩恩，就是类似于把闪存当作eeprom来用

那你可以使用 EasyFlash ：https://github.com/armink/EasyFlash

然后参考文档（点击查看），开启磨损（擦写）平衡模式，应该能满足你的需求。

myxiaonia · 发表于 2016-11-16 22:43:03

sunnydragon 发表于 2016-11-16 18:56
那你可以使用 EasyFlash ：https://github.com/armink/EasyFlash

然后参考文档（点击查看），开启磨损 ...

我特意去看了你的easyflash中env的实现方法，每个env是作为整体进行操作的，当然擦写平衡后我估计会使用类似fat32文件系统的做法，就是扇区顺序使用，类似于环形队列一样，但是这应该是对一个个env之间的做法

对于大量数据集合的形式用现在的env不大合适，因为修改很可能是其中一个字节，也可能是几kb这样的，如果将这个大数据集合拆分为多个互不相干的env，某些操作比如清空同一组参数就需要操作n次，而数据集合中
这些数据都是连续存放的，一条语句就完成了，用一个env的话，修改一个自己也写一遍整个env又太奢侈

有没有可能只对修改部分保存，但是开机读取这个env时又能准备的恢复过来

myxiaonia · 发表于 2016-11-16 22:49:55

我自己现在的做法，大数据集合动态保存的做法，每次修改则记录偏移地址和长度，然后写入到flash，当然各种校验机制和写入策略都是有考虑的

sunnydragon · 发表于 2016-11-17 07:42:55

myxiaonia 发表于 2016-11-16 22:49
我自己现在的做法，大数据集合动态保存的做法，每次修改则记录偏移地址和长度，然后写入到flash，当然各种 ...

是的，EasyFlash 现有实现方式虽然简单，但是针对大数据支持资源占用会非常高，所以目前还不太适合这类场景。

最近一直业余时间一直在忙 EasyLogger 的开发，在 EasyFlash 的后续开发计划中，会新增一种轻量级模式，所有数据无需再开辟内存进行缓存，保存在 Flash 的数据会使用压缩算法进行压缩，Env 的名字不在采用字符串存储等等很多降低系统资源占用的处理，欢迎继续关注 EasyFlash 的进展哈~

weiwei4 · 发表于 2016-11-17 08:49:35

不错不错，好资源

sunnydragon · 发表于 2016-11-20 21:03:32

weiwei4 发表于 2016-11-17 08:49
不错不错，好资源

jie5313 · 发表于 2016-11-20 21:32:14

非常有帮助，谢了。。。。。。。。

sunnydragon · 发表于 2016-11-29 08:03:26

jie5313 发表于 2016-11-20 21:32
非常有帮助，谢了。。。。。。。。

kaomantou · 发表于 2016-12-2 12:28:00

多谢分享~~~~~~~~~··

chxaitz · 发表于 2016-12-2 14:15:26

非常好用，赞一个～

闲鱼翻身 · 发表于 2016-12-2 16:52:43

正好项目要用到，试试

johnny412 · 发表于 2016-12-2 19:05:04

下载看看，多谢分享！

sunnydragon · 发表于 2016-12-7 09:31:24

chxaitz 发表于 2016-12-2 14:15
非常好用，赞一个～

多谢支持哈~

jackem · 发表于 2016-12-25 23:32:28

这个帖子我继续再顶！

talkingbeast · 发表于 2016-12-25 23:43:09

谢谢分享，高质量的资料。

miaoguoqiang · 发表于 2017-1-22 15:09:31

Linux下怎么加到自己的进程中。需要把整个源码全部加入？

sunnydragon · 发表于 2017-1-23 10:40:55

miaoguoqiang 发表于 2017-1-22 15:09
Linux下怎么加到自己的进程中。需要把整个源码全部加入？

是的，你可以先试一下 Linux 的 Demo

XLoveEE · 发表于 2017-1-24 09:14:06

可以,关注下!

miaoguoqiang · 发表于 2017-5-15 14:36:33

本帖最后由 miaoguoqiang 于 2017-5-15 14:38 编辑

没看到linux下对日志的分割处理，相对于log4c，觉得log4c使用起来比较便捷

cyberkit · 发表于 2017-5-16 09:59:26

相当给力，赞！

STT · 发表于 2017-5-19 10:43:29

标记一下以后方便查找

游在云间 · 发表于 2017-8-14 05:33:55

可以移植到freertos中吗？

sunnydragon · 发表于 2017-8-14 08:09:37

游在云间发表于 2017-8-14 05:33
可以移植到freertos中吗？

当然可以。可以参考下其他 OS 的 Demo 。

Harlan · 发表于 2017-11-11 14:26:12

非常好，方便故障跟踪

Baldwin · 发表于 2019-4-2 16:00:52

请问在移植easyLogger时，keil5.17环境，编译时报错，是什么原因呢？
static const char *level_output_info[] = {
      [ELOG_LVL_ASSERT]  = "A/",
      [ELOG_LVL_ERROR] = "E/",
      [ELOG_LVL_WARN] = "W/",
      [ELOG_LVL_INFO] = "I/",
      [ELOG_LVL_DEBUG] = "D/",
      [ELOG_LVL_VERBOSE] = "V/",
};

..\Module\easyflash\src\elog.c(118): error:  #29: expected an expression

sunnydragon · 发表于 2019-4-2 16:04:39

Baldwin 发表于 2019-4-2 16:00
请问在移植easyLogger时，keil5.17环境，编译时报错，是什么原因呢？
static const char *level_output_inf ...

keil 里开启 C99 支持就好了

Baldwin · 发表于 2019-4-2 16:08:24

sunnydragon 发表于 2019-4-2 16:04
keil 里开启 C99 支持就好了

可以了，谢谢

Baldwin · 发表于 2019-4-3 09:22:55

按照github上移植手册进行了移植，https://github.com/armink/EasyLo ... cs/zh/port/flash.md
为什么elog_flash.c中还需要调用easyflash.c easyflash.h？能否介绍一下文件调用方式和移植，谢谢

蛋定 · 发表于 2019-4-3 15:07:27

好东西，标记下

BCE312 · 发表于 2019-12-5 19:00:08

厉害了！

huhandong · 发表于 2019-12-5 22:47:56

好东西，收藏先

malaoshi · 发表于 2019-12-9 13:51:31

好东西，做个记号。

hall · 发表于 2020-4-30 10:47:23

简单移植了一下，效果挺好！还要请教楼主两个问题：
1.好像不支持打印很长的带换行的字符串？比如像下面图片这样的。按我理解需要把这个logo存到一个大数组里，再用easylogger打印，我试了一下只能打印一部分，也不会换行。
2.easylogger没有输入命令的功能吧？比如在SecureCRT里用键盘做交互。

sunnydragon · 发表于 2020-4-30 20:48:36

hall 发表于 2020-4-30 10:47
简单移植了一下，效果挺好！还要请教楼主两个问题：
1.好像不支持打印很长的带换行的字符串？比如像下面图 ...

1、这种其实按行打印就好，每一行对应一个日志代码
2、elog 主要负责日志输出，命令输入，还是得依赖于其他组件

hall · 发表于 2020-5-1 00:34:45

sunnydragon 发表于 2020-4-30 20:48
1、这种其实按行打印就好，每一行对应一个日志代码
2、elog 主要负责日志输出，命令输入，还是得依赖于其 ...

懂了，感谢作者回复！

richards · 发表于 2020-5-1 00:44:57

不错不错

chinazhsj · 发表于 2020-12-31 16:45:06

好东西啊，赶紧研究一下

【升级】C/C++ 日志库 EasyLogger 新增彩色日志、异步输出等

本帖子中包含更多资源

阿莫论坛20周年了！感谢大家的支持与爱护！！

本帖子中包含更多资源

本帖子中包含更多资源