沙箱管理（Sandboxes）
沙箱页是日常操作最频繁的 Dashboard 页面。你可以在这里完成：
- 查看所有沙箱
- 按状态筛选与搜索
- 创建新沙箱
- 进入详情页查看资源、Metadata 与日志
- 执行暂停、恢复和终止操作
沙箱列表与筛选
沙箱列表页通常会展示以下字段：
- 状态
- 沙箱 ID
- 模板 ID
- CPU
- 内存
- 所在节点或 client 信息
- 启动时间
- 操作按钮
同时，页面一般支持以下两类筛选：
搜索框
可按以下信息做模糊搜索：
sandboxIDtemplateIDaliasclientID
状态标签
通常支持：
allrunningpaused
如果你的目标是排查暂停后的恢复行为、长时间运行实例，或刚创建失败的实例，这些筛选会很有帮助。
新建沙箱
沙箱页右上角通常会有 New Sandbox 按钮，进入后会打开一个专门的新建页面。
新建沙箱时，Dashboard 主要要求你完成两件事：
1. 选择模板
只有状态为 READY 的模板才适合作为新建沙箱的基础。若当前没有可选模板，请先回到 模板管理。
2. 填写 Metadata
Dashboard 支持为沙箱附加键值对形式的 metadata。这类信息常用于：
- 标记业务上下文
- 帮助值班或运维识别用途
- 让后续日志、排障和检索更容易
提交后，通常会直接跳转到新创建沙箱的详情页。
列表列怎么读
状态
常见状态包括：
runningpaused- 其他中间态或异常态
对于日常管理，最重要的是区分“正在运行”与“已经暂停”。
CPU / 内存
这两列帮助你快速判断该沙箱的资源规格是否符合预期。如果你发现异常大的规格或明显不匹配的配置，应回看模板参数。
节点 / Client
列表中的节点或 clientID 能帮助你快速定位该沙箱归属到哪个节点或客户端线索。当你需要从集群资源视角排查时，可以转到 节点与容量。
沙箱详情页看什么
点击沙箱 ID 后，通常会进入详情页。详情页适合回答以下问题：
- 当前沙箱是什么状态
- 它由哪个模板创建
- 使用了多少 CPU 和内存
- 对应的域名或访问入口是什么
- 携带了哪些 Metadata
- 最近输出了哪些日志
在详情页里，通常会看到三个信息区块：
Resources
包括：
- vCPU
- Memory
- Client
- Alias
- Started 时间
- Domain
Runtime
包括：
- 启动时间
- 当前状态
- 运行时相关版本信息
Metadata
这里会直接展示你创建时附加的键值对，适合排查请求来源或业务标记。
生命周期操作：Pause / Resume / Kill
沙箱页和详情页都可能直接提供生命周期操作按钮。
Pause
适合临时释放活跃运行状态，但保留后续恢复可能性的场景。
Resume
用于将已暂停沙箱重新恢复为运行状态。恢复成功后，建议立刻看状态和日志是否正常。
Kill
用于彻底终止沙箱。这个操作通常不可逆，适合清理异常实例、结束测试实例或回收资源。
日志查看与常见排障
沙箱详情页通常会内置日志面板，并自动滚动到最新位置。日志适合用来确认：
- 服务是否正常启动
- 探针或业务逻辑是否报错
- 恢复后是否重新进入可服务状态
没有日志时先检查什么
- 模板是否真的已经
READY - 沙箱是否还没成功进入运行态
- 当前实例是否在非常早期就失败
日志不断报错时怎么办
可以按下面顺序判断：
- 先确认模板是否正确
- 再确认 Metadata 或业务参数是否有问题
- 再确认节点是否资源紧张
- 最后结合运维日志和 CLI 继续排障
如果你还不确定问题主要集中在哪一层，可以先回到 可观测性（Observability） 做一次综合判断。
如果你已经确认是运行期问题（日志中断、resume 异常、guest 登录失败），建议直接查看 沙箱运行排障。
如果你重点要查的是“为什么没有日志”或“为什么 cube-runtime login 进不去 guest”，建议继续查看 沙箱日志与 Guest 登录排障。
典型使用路径
路径一：验证新模板
- 在模板页确认模板
READY - 到沙箱页创建新沙箱
- 打开详情页查看日志
- 如一切正常，再继续接入业务 SDK
路径二：排查线上异常实例
- 按状态或关键字搜索目标沙箱
- 进入详情页看资源与日志
- 如果需要，执行 Pause / Resume 或 Kill
- 再回节点页确认该节点是否存在更广泛问题