沙箱观测
一、运维管理概览
沙箱服务提供日志、监控和配额管理能力，帮助您定位实例异常、观察资源使用情况并保障业务容量。
- 任务失败或实例异常时，先查看沙箱日志定位报错
- 发现性能问题或资源不足时，查看沙箱监控确认 CPU、内存和创建延迟
- 接近资源、实例数量或速率上限时，在配额管理中申请提额
二、沙箱日志
沙箱日志用于查看实例运行期间产生的标准输出（stdout）和标准错误（stderr），帮助您排查启动失败、命令执行失败和运行异常等问题。
日志支持查看当前沙箱与历史沙箱；历史沙箱是已删除的实例。
查看日志
- 进入沙箱日志页面。
- 按需设置筛选条件：沙箱类型、关联模板和统计周期。
- 在“沙箱名称”中选择一个或多个实例。
- 当前沙箱：运行中、休眠中或异常的实例。
- 历史沙箱：已删除的实例。
- 页面会按所选沙箱分组展示日志。默认展开第一个沙箱，其他沙箱可按需展开。
- 在日志内容中查看 stdout 与 stderr，并通过滚动条浏览长日志。
【注意事项】
- 请将日志中的 API Key、密码、访问令牌等敏感内容妥善处理后再进行共享。
- 已删除沙箱仅能在可回溯的日志周期内查询，建议在销毁重要实例前保存关键日志或创建快照。
三、沙箱监控
沙箱监控提供项目维度的资源利用和服务质量数据，帮助您判断资源是否紧张、沙箱创建是否稳定，以及问题是否集中在某类模板或实例。
设置监控范围
- 进入沙箱监控页面；
- 设置时间范围：最长可查询 7 天数据；
- 按需选择沙箱类型和关联模板；
- 如需持续观察，可开启自动刷新，并自定义间隔时间。
查看指标概览
监控页面展示以下六项指标：
指标 | 含义 |
创建沙箱 | 当前筛选条件和时间范围内创建的沙箱总数。 |
异常沙箱 | 当前筛选条件下出现异常的沙箱总数。 |
请求成功率 | 创建、暂停、恢复、停止和连接沙箱操作中，成功请求所占比例。 |
创建延迟 P95 | 95% 的创建请求可在该时间内完成，用于评估创建稳定性。 |
CPU 平均使用率 | 实际使用 CPU 核数占实例 CPU 配额的平均比例。 |
内存平均使用率 | 实际使用内存占实例内存配额的平均比例。 |
查看趋势图
资源利用趋势
- CPU 平均使用率：实例已使用 CPU 核数 ÷ CPU 配额核数 × 100%，并求平均
- 内存平均使用率：实例已用内存 ÷ 内存配额 × 100%，并求平均
服务质量趋势
- 请求成功率：各类生命周期操作中返回成功状态的比例
- 创建沙箱请求速率：平均每秒发起的创建沙箱请求数
- 创建沙箱延迟：展示平均值、P90 与 P95，反映从服务收到请求到实例创建完成的耗时
四、配额管理
配额管理用于查看项目可使用的资源总量、单沙箱能力上限、并发沙箱数量和创建速率限制，并支持一次提交多个指标的提额申请。
📌 注意：请先确保账号下至少有一个沙箱类型的API Key
创建路径：顶部导航选择「系统管理」→ 侧方导航选择「API Key 管理」→ 点击「创建 API Key」→ 类型选择「沙箱」→ 点击「确认」完成创建
在配额管理页面查看以下三类指标：
- 资源配额
- CPU 总量
- 内存总量
- 共享存储配额总量
- 沙箱配额
- 单沙箱 CPU 上限
- 单沙箱内存上限
- 并发沙箱数
- 单沙箱可用存储空间
- 速率限制
- 沙箱创建速率
页面会展示平台默认上限和当前项目上限。实际可用资源还受当前已使用资源影响。
4.1 何时需要申请提额
出现以下情况时，建议申请提额：
- 无法创建新沙箱，且并发沙箱数已接近上限。
- 任务需要超过当前单沙箱 CPU 或内存上限的规格。
- 批量任务在短时间内创建大量沙箱，创建速率受限。
- 快照或模板占用较多，项目共享存储容量达到预警或不足。
建议：申请前先清理无用快照、废弃模板和闲置实例。提额解决的是容量问题，不会修复镜像、启动命令或应用本身的异常。
4.2 提交提额申请
- 在配额管理页面右上角单击申请提额。
- 在“申请项目”中勾选一个或多个需要提高的指标。
- 为每个勾选项填写期望的申请上限，申请值必须大于当前上限。
- 填写申请原因，说明业务场景、预计规模和使用周期。
- 填写联系电方式
- 单击提交申请，平台会尽快处理您的提额申请
4.3 常见问题
提额申请为什么无法提交？
请检查是否至少勾选一个申请项；每个申请上限必须为大于当前上限的正数；申请原因和联系电话不能为空。
申请提交后何时生效？
申请提交后进入人工评估流程。是否通过及具体生效时间以审批结果为准。
配额充足但创建仍失败怎么办？
配额只代表资源上限。请同时查看实例日志、模板状态、镜像构建状态及网络/存储配置；若创建延迟或请求成功率异常，可结合监控进一步定位。
五、用量统计
用量统计用于查看当前项目在指定时间范围内的沙箱资源使用情况，帮助您识别资源消耗趋势、定位高用量模板，并及时清理闲置快照和模板。当前支持查看两类用量：
- 计算用量：沙箱运行期间消耗的 vCPU 和内存资源，支持按照沙箱类型及模版筛选；
- 共享存储用量：模板和快照占用的存储资源。
说明
- 用量数据存在约 1 小时延迟，最新产生的用量可能不会立即展示。
- 用量统计用于资源管理与趋势分析；实际费用请以账单为准。
页面路径：顶部导航选择「系统管理」→ 侧方导航选择「用量统计」→ Tab 切换为「沙箱」
