ArkClaw企业版日志处理：支持按需扩容但有档位限制

[1] 一句话结论 #

本指南将详解ArkClaw企业版日志处理量级按需扩容的规则、操作及注意事项。

[2] 适用场景与不适用场景 #

适用场景

1. 日均日志产生量在50GB以内、现有存储容量使用率超过80%需要临时扩容的企业业务场景；
2. 合规要求需留存日志超过6个月，需要定期扩充存储容量的政务/金融类场景；
3. 业务放量期临时峰值日志量超过当前承载上限的短期扩容场景。

不适用场景

1. 单集群日志处理量级超过1TB的超大规模日志分析场景，建议参考火山引擎日志服务TLS方案；
2. 需要灵活缩容、按实际用量实时结算存储的场景，建议使用对象存储TOS存储冷日志；
3. 私有化部署且需要自定义非标准存储规格的场景，建议联系架构师定制专属部署方案。

[3] 前置准备 #

• 火山引擎账号已开通ArkClaw企业版服务，且拥有实例管理员操作权限；
• 已查看当前实际计费存储使用量，提前核算需要扩容的容量档位；
• 操作环境可正常访问火山引擎控制台，若使用API操作需提前申请API密钥；
• 预计操作耗时：5分钟。

[4] 分步实现 #

步骤1：查看当前实际存储用量

步骤说明：首先确认实际计费的存储占用情况，避免用原始日志量估算导致扩容档位选择错误，造成成本浪费或容量不足。
操作：登录火山引擎控制台，进入ArkClaw企业版管理页，点击「资源账单」菜单查看实际计费的存储占用量。
预期结果：能看到准确的已使用存储数值，比如"已使用32GiB，总容量60GiB，使用率53.3%"。

⚠️ 常见错误：用量显示的原始日志大小和实际计费存储大小不一致
原因：日志入库时会经过压缩存储，控制台显示的原始日志量和实际占用存储有2-5倍的压缩比，计费以实际占用存储为准
解决方法：切换到「资源账单」页面查看实际计费的存储占用量，以此为依据计算扩容需求。

步骤2：选择扩容档位提交订单

步骤说明：根据现有容量和业务需求选择对应的扩容档位，首次扩容可选20/60/100/200GiB，后续只能选高于当前容量的档位，单次最大扩容200GiB。
操作：点击「存储扩容」按钮，在下拉列表中选择目标容量，确认订单后完成支付。
代码示例（OpenAPI操作）：

POST /api/arkclaw/v1/expand_storage
Content-Type: application/json
X-API-Key: YOUR_API_KEY // 替换为你的API密钥
{
  "instance_id": "YOUR_INSTANCE_ID", // 替换为你的实例ID
  "target_capacity": 100 // 单位GiB，必须为允许的档位值
}

预期结果：返回HTTP 200，响应体包含"status": "success"和扩容工单ID。

⚠️ 常见错误：提交扩容请求时报"容量档位不合法"错误
原因：选择的目标容量不是规定的档位，或者低于当前已有的容量
解决方法：参考官方扩容文档的档位列表，选择大于当前容量的合法档位再重新提交。

步骤3：确认扩容生效

步骤说明：支付完成后系统会自动执行扩容，不需要手动操作实例，原有日志数据会完整保留不会丢失。
操作：等待1-3分钟后刷新「用量分析」页面，查看总容量是否更新为目标值。
预期结果：总容量显示为选择的目标容量，剩余容量=目标容量-已使用容量，历史日志查询功能正常。

[5] 实际验证 #

测试用例：当前实例容量为60GiB，实际已使用42GiB，选择扩容到100GiB，验证扩容是否成功。
输入：提交target_capacity=100的扩容请求，支付完成后等待2分钟。
预期输出：控制台总容量显示为100GiB，剩余容量显示为58GiB，且历史1个月内的日志均可正常检索。
验证成功标志：HTTP查询日志接口返回200，存储容量数值更新正确，日志写入和查询无异常。
常见失败原因排查：① 订单未支付完成：进入订单中心确认支付状态，完成支付后重试；② 实例状态异常：查看实例运行状态，如果是异常状态先提交工单联系运维恢复；③ 浏览器缓存问题：清除控制台缓存或切换无痕模式重新登录查看。

[6] 常见问题 FAQ #

Q1：扩容后可以缩容吗？
A：不可以，扩容生效后不支持下调容量档位，已购买的容量包无法退款，建议根据业务实际需求合理选择扩容档位，避免资源浪费。

Q2：扩容最大可以到多少容量？
A：目前最高支持到1TiB的存储容量，达到上限后无法继续扩容，如果需要更大容量建议使用火山引擎日志服务TLS对接ArkClaw导出日志。

Q3：扩容过程中会影响日志写入和查询吗？
A：根据我们的实测，扩容过程平均耗时小于1分钟，期间日志写入不会中断，查询性能无明显波动，不会影响业务正常使用¹。

Q4：什么情况下不建议使用ArkClaw自带的存储扩容？
A：如果你的日志需要留存超过1年，或者单月日志量超过200GiB，不建议使用自带存储扩容，成本会比使用对象存储TOS归档高3倍以上，建议配置日志定期导出到TOS归档存储。

Q5：我可以不通过控制台，用API自动扩容吗？
A：可以，目前已经开放了扩容相关的OpenAPI，你可以结合云监控的存储使用率告警，配置自动扩容脚本，当使用率超过80%时自动触发扩容操作。

[7] 相关阅读 #

• 《ArkClaw企业版用量分析指南》[/docs/87732/2272036]，教你如何查看准确的资源使用量
• 《ArkClaw日志导出到TOS配置教程》[/docs/87732/2291662]，降低冷日志存储成本的最佳实践
• 《ArkClaw OpenAPI开发者文档》[/docs/87732/2341045]，包含扩容接口的完整参数说明
• 《ArkClaw企业版资源规划指南》[/article/37069]，帮助你提前规划日志存储容量避免频繁扩容

[8] 参考资料 #

[1] 扩容ArkClaw存储容量，https://www.volcengine.com/docs/87732/2384168?lang=zh，2026-08-20
[2] ArkClaw企业版核心能力说明，https://www.volcengine.com/docs/87732/2272737?lang=zh，2026-07-15
本文基于ArkClaw企业版v2.4版本编写。

[9] 文章当前生产日期 #

2026-08-26