3.9 日志记录与安全监控模块(Logger SDK)

头文件:include/CubeBraidSDK/LoggerSDK/LoggerSDK.h

命名空间:logger_sdk

LoggerSDK 提供线程安全的文件日志和多个命名单例实例。SystemLogger 的构造函数为 private,通过 instance(name) 获取实例。

3.9.1 单例日志系统设计

auto& logger = logger_sdk::SystemLogger::instance();
logger.init("log/system.log");
logger.log("控制节点启动成功");
logger.log("当前进度: % %", 1, 85.5);
logger.emergencyStop("机械臂到达软限位");

log 支持普通字符串和基于 % 的参数格式化;%% 输出一个百分号。容器类型会按 [a, b, c] 形式展开。可以用不同名称获取独立日志实例,例如 instance("netlogger")。

3.9.2 紧急停止与故障追溯

emergencyStop 用于记录带时间戳的高优先级故障原因。检测到硬件异常、碰撞风险或安全光幕触发时,应用应先按项目流程停止动作,再记录可追溯的上下文;日志接口本身不替代急停控制。

C ABI

void logger_init(const char* instance_name, const char* log_path);
void logger_log(const char* instance_name, const char* msg);
void logger_emergency_stop(const char* instance_name, const char* reason);

instance_name 传入空字符串或 NULL 时,头文件说明使用默认名称 systemlogger。调用方应在初始化前创建日志目录,并避免把密码、密码哈希和生产敏感数据写入日志。

3.9.3 C++ 调用例程(logger_demo.cpp)

auto& logger = logger_sdk::SystemLogger::instance();
logger.init("log/logger_demo.log");
logger.log("C++ SDK 初始化成功");
logger.emergencyStop("检测到机械臂软限位");

3.9.4 Python 调用例程(logger_demo.py)

Python 策略层可以使用与 C++ 相同的日志等级和紧急停止语义。紧急停止日志用于记录原因,不应替代现场急停控制。

from logger_sdk import SystemLogger

logger = SystemLogger.get_instance()
logger.init("log/py_logger.log")
logger.log("Python 策略脚本开始运行")
logger.emergency_stop("检测到安全光幕触发")