云控日志CloudLog

Cc812487000 · 发表于 2023-8-12 16:44:44

快速本地使用：
1. 在Windows电脑上，我们推荐使用WM_COPYDATA消息进行日志传输，资源占用最少，速度最快。
2. 如果您的应用程序已经具备UDP或TCP功能，可以直接通过原有的Socket将日志发送到本机的127...1。
3. 对于嵌入式系统的本地调试，您可以通过串口、USB或网口来进行日志传输。

便捷远程及云端使用：
1. 您可以在路由器中设置端口转发功能，将对应的端口转发到安装了CloudLog的电脑上。
2. 为了方便获取到电脑所在的IP地址，我们建议使用动态域名系统（DDNS）服务。
3. 使用云控域名账号，在服务器上保存日志，您可以随时打开CloudLog回读所有未读过的日志。

CloudLog的日志元素介绍：
1. 日志等级（Log Level，简写为LL）用于确认日志的重要性。
2. 日期时间Tick（Date Time tick，简写为DT）用于确定日志生成的时刻。
3. 应用名（App Name，简写为AN）用于确认日志的来源项目或进程。
4. 标签（Tag，简写为TA）用于按模块化区分日志。
5. 线程标识符（Thread Identity，简写为TI）用于区分多线程。
6. 文字内码（Text Code，简写为TC）用于实时调整当前的内码。
7. 日志文字（Log Text，简写为LT）可以使用任何内码进行记录。
8. 日志缓冲（Log Buffer，简写为LB）可以传送阵列缓冲。
9. 计时功能可以根据前一条日志的tick，计算出精确到1微秒的用时。

CloudLog的日志等级说明：
1. Error级别表示严重的问题或软件执行功能错误，是最高等级的日志，无法屏蔽。
2. Warn级别表示可能出现潜在错误的情况，当选择Error级别时，Warn级别的日志将不会显示。
3. Info级别强调应用程序运行过程中的一些重要信息。
4. Debug级别仅在开发期间有用的调试消息，等级较低，在正式发布时一般不会出现。
5. Buffer阵列数值直接显示等级与Debug相同。
6. Fixer级别用于固定位置显示日志，这些日志不保存到log文件中。

CloudLog的日志过滤器功能：
1. 可以根据日志等级及各种组合来过滤日志记录。
2. 关键词可以高亮显示，以增强可读性，您可以自定义加大、加粗或指定专门的颜色进行高亮突出显示。
3. 您可以指定关键词，使含有指定关键词的日志不显示。
4. 您也可以指定关键词，使含有指定关键词的日志显示。
5. 您还可以根据应用名中的关键词进行显示过滤。
6. 同样地，您可以根据标签中的关键词进行显示过滤。

CloudLog支持的键值对风格文字：
1. 使用'&'分隔各个日志元素，每个元素由键值':'数值组成。
2. 日期时间Tick、日志文字及日志缓冲的数值使用Base64编码。
3. 应用名、标签及线程标识符一般只使用数字或字母。
4. 日期时间可以选择是否传送，可以是2字节的毫秒（ms）、3字节的微秒（us）或8字节的全部时间。
5. 一个简单的示例："hello"日志可以表示为：ll

&/aGVsbG8=

CloudLog支持的简易风格文字：
1. 使用空格分隔各个日志元素，请勿调换元素的顺序。
2. 最少包含日志等级（LL）空格及日志文字（LT）。
3. LL+LT+文字，LT表示4位数的毫秒tick，范围从000到9999，最大可以表示10秒的时间间隔。
4. LL+LT+TAG+文字，TAG标签用于按模块化区分日志，一般使用字母表示。
5. LL+LT+TAG+TI+文字，TI为-9的数字，表示线程标识符。
6. LL+LT+TAG+TI+TC+文字，TC为G=GBK内码或U=UTF-8内码。

使用开源库CloudLog的方法：
1. 直接从 https://gitee.com/hsav20/CloudLog.git 克隆整个仓库。
2. 将CloudLog.c和CloudLog.h文件添加到您的项目中。
3. 在对应的平台目录（如PlatformWindows）中找到一个最接近的模板文件FwbConf.h，并将其复制到您的项目中。
4. 根据您的实际使用环境，修改FwbConf.h中的配置信息。
5. 参考PlatformWindows目录下的main.c文件，您可以了解如何输出不同类型的日志。