酷唱科技

CloudLog云控日志系统

CloudLog云控日志系统是一款综合性的日志管理软件，旨在为用户提供高效、灵活的日志收集、处理和展示方案。该系统能够适应多种设备，包括个人电脑、智能手机以及嵌入式设备（如STM32微控制器），确保日志数据的全面性和实时性。CloudLog不仅适用于本地部署，还能无缝对接云端环境，满足不同场景下的日志管理需求。

本地操作指南

在本地环境中使用CloudLog时，以下是一些推荐的操作步骤：

1. Windows电脑客户端：建议优先使用WM_COPYDATA消息，这种方法具有最低的资源占用和最快的处理速度。
2. 现有网络功能：如果您已经拥有UDP或TCP功能的应用软件，可以直接通过这些Socket将日志发送至本地计算机的127.0.0.1端口。
3. 嵌入式系统调试：对于嵌入式系统的本地调试，您可以通过串口、USB或网络接口进行数据通信。

远程与云端操作指南

对于远程和云端环境的日志管理，以下是一些操作建议：

1. 端口映射：在路由器上设置端口映射，将指定端口转发至运行CloudLog的服务器。
2. 动态域名解析（DDNS）：使用DDNS服务获取服务器的动态IP地址，便于远程访问。
3. 云控账号：在服务器上创建云控账号，以便通过CloudLog随时查看和回溯未读日志。

CloudLog的核心日志特性

CloudLog提供了丰富的日志特性，帮助用户进行深入分析和高效管理：

• 日志级别：通过不同级别标识日志的重要性。
• 时间戳：精确记录日志生成的具体时间。
• 应用标识：明确日志来源的应用或进程。
• 标签：按照模块化方式组织日志。
• 线程ID：区分多线程环境下的日志。
• 字符编码：支持实时调整日志的字符编码。
• 日志内容：表示日志信息，支持多种字符编码。
• 日志缓冲：缓冲存储日志数据。
• 计时器：基于前一条日志的时间戳，计算精确到微秒的执行时间。

日志级别支持

CloudLog支持多种日志级别，以便于区分日志的重要性和用途：

• Error：表示严重错误或功能故障，级别最高，不可忽略。
• Warn：表示可能出现的错误情况，不包含在Error级别中。
• Info：强调应用程序运行中的重要信息。
• Debug：仅用于开发调试的日志消息，级别较低。
• Buffer：直接显示的数组数据，级别与Debug相同。
• Fixer：固定位置显示日志，不保存至日志文件。

过滤器功能

除了日志级别过滤，CloudLog还提供了多种过滤器功能，以增强日志处理的灵活性：

• 组合过滤：根据日志级别和其他条件组合过滤日志记录。
• 关键词高亮：高亮显示关键词，并支持字体加粗和颜色调整。
• 关键词显示选项：选择是否在日志中显示关键词。
• 应用名和标签过滤：根据应用名或标签进行日志筛选。

日志信息展示

CloudLog采用键值对形式的文本来展示日志信息，具体包括：

• 元素分隔：使用‘&’符号分隔不同的日志元素，每个元素由键和值组成。
• Base64编码：日期时间戳、日志内容和日志缓冲使用Base64编码。
• 字符和数字：应用名、标签和线程ID通常只包含数字或字母。
• 时间格式：日期时间可以采用不同的格式，如不传输、2字节毫秒、3字节微秒或8字节完整时间。

使用开源的CloudLog库

如果您打算使用开源的CloudLog库，请按照以下步骤操作：

1. 从https://gitee.com/hsav20/CloudLog.git克隆库代码。
2. 将CloudLog.c和CloudLog.h文件集成到您的项目中。
3. 选择与您的平台最匹配的配置文件（如FwbConf.h）并将其复制到项目中。
4. 根据您的使用环境修改FwbConf.h文件。
5. 参考PlatformWindows目录下的main.c文件，学习如何输出不同类型的日志。
6. 使用xmake编译PlatformWindows\\\\\\\\KeysGbk或KeysUtf8。

如果您在使用CloudLog时遇到任何问题或需要帮助，请随时联系我们。我们的技术支持团队将竭诚为您提供解决方案。