文档目录

问题说明

本文用于排查“计费 UI 空白 / 账单页面异常”类问题。

适用环境

  • 产品:ZCF
  • 组件:Cloud
  • 涉及对象:计费账单/UI
  • 版本:4.x、5.x
  • 场景:计费 UI 空白 / 账单页面异常

问题现象

  • 账单计费页面空白、项目计费不显示、账单数据加载失败。

可能原因

  • 计费模块数据、价目绑定、项目关系、数据库历史数据或 UI 查询异常。

排查步骤

  1. 确认计费功能是否启用、影响范围是项目还是全局。
  2. 检查浏览器 F12 和 management-server 日志中的计费接口。
  3. 核对项目、价目、账单周期和数据库表增长情况。

关键命令

grep -a -nE "bill|billing|price|VmUsage|Usage" /usr/local/zstack/apache-tomcat/logs/management-server.log*

解决方案

  • 按排查结果修复对应组件、配置、数据状态或链路问题。
  • 若涉及数据库、底层存储、快照链、云主机磁盘、GPU 直通或管理服务重启,先确认备份、影响面和回滚路径。

验证方法

  • 复核本文所述现象是否消失。
  • 平台 UI、API、管理节点日志和底层命令输出能够相互印证。
  • 至少观察一个相关任务周期或告警周期,确认问题不再复现。

风险与回滚

  • 生产环境执行修复前必须确认客户业务影响、变更窗口和回滚方案。
  • 涉及数据删除、数据库修改、快照链修复、底层文件处理和硬件操作时,建议联系 ZStack 官方技术支持确认。

注意事项

  • 涉及管理服务、数据库、证书、权限、审计和安全配置调整时,应先确认 HA 状态、业务窗口、回退方案和合规保留要求。
  • 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更,应联系 ZStack 官方技术支持确认后再执行。
ZStack Cloud 账单计费 UI 空白页排查 | 故障排查 · KB | ZStack 资源中心