SuperAPI AI 工具集

rock-debug

测试与质量

查看项目

更新于 10-16 07:23

技能介绍

用途:对 ROCK 沙箱做只读故障排查,通过 rockcli(rc)观察日志、操作历史、状态和回放来定位问题,不修改沙箱内部文件或进程。仅在用户明确要求修复沙箱内部内容时,才需先获得用户确认。具体命令参考见配套技能 rock-cli。

主要能力:确认沙箱状态(pending → alive → stopping → stopped);存活时可用 exec、日志搜索、tail、history、replay;已停止时仍可查 history、搜索日志、下载日志、回放请求序列。支持按日志文件(command.log、access.log、rocklet.log、rocklet_uvicorn.log)与时间窗口(-m、-s、-e)过滤,也可用集群维度日志回溯沙箱在集群层面的事件。

使用方式:先执行 rockcli sandbox <id> status 确认状态,再按状态分支排查。存活时检查环境依赖、进程、资源、HTTP 状态;停止后通过 history 与日志回溯,必要时用 replay 在新沙箱复现。接口调用失败时,可先用集群日志搜索 stop 事件,对比停止时间与失败时间,判断是用户主动停止、自动过期还是意外崩溃,再结合 rocklet.log、command.log、access.log 深挖根因。

适用场景:沙箱启动卡 pending、exec 无输出或超时、OOM 或被 kill、磁盘满、HTTP 5xx、沙箱突然 stopped、接口调用失败定位停止原因、磁盘占用突然飙升、问题无法复现等。

限制:全程只读,不修改沙箱;沙箱停止后无法 exec 或 tail,只能依赖历史与日志;诊断中的猜测或推断需及时与用户确认,用户不认可则继续分析,认可并同意后才深入;输出过多时应缩小时间窗口或指定日志文件。具体收费、价格、平台与效果等资料暂未提供。