RuleGo-Server 提供规则链执行日志的持久化存储和查询能力，支持多种存储后端。

配置

# 是否持久化执行日志
save_run_log = true
# 存储后端类型：bbolt（默认）、file、nop
run_log_store_type = bbolt

存储后端

类型	说明	适用场景
bbolt	内嵌键值数据库（默认）	生产环境，性能好
file	JSONL 文件存储	调试、日志导出
nop	不存储	不需要日志记录

查询执行历史

GET /api/v1/logs/runs?chainId={chainId}&page=1&size=20&startTime=&endTime=
Authorization: Bearer {token}

查询参数：

参数	类型	说明
chainId	string	规则链 ID 过滤
id	string	指定运行记录 ID
page	int	页码
size	int	每页数量
startTime	string	开始时间过滤
endTime	string	结束时间过滤

获取单条记录

GET /api/v1/logs/runs?id={runId}
Authorization: Bearer {token}

删除记录

# 按规则链删除
DELETE /api/v1/logs/runs?chainId={chainId}

# 按记录 ID 删除
DELETE /api/v1/logs/runs?id={runId}
Authorization: Bearer {token}

节点调试数据

获取规则链节点的调试日志：

GET /api/v1/logs/debug?chainId={chainId}&nodeId={nodeId}
Authorization: Bearer {token}

节点调试日志的记录由 debug 和 max_node_log_size 配置控制：

# 是否记录节点调试数据
debug = true
# 每个节点最大日志条数
max_node_log_size = 40

在编辑器中查看

• 调试控制台：底部面板实时显示节点 IN/OUT 数据
• 节点调试面板：点击节点查看历史调试日志
• 执行历史：运行对话框中查看历史执行记录

WebSocket 实时调试

参见 REST API 参考 - 实时调试。