文档目录

问题说明

本文用于排查“UI 告警对象口径 / 事件对象理解差异”类问题。

适用环境

  • 产品:ZCF
  • 版本:4.x、5.x
  • 组件:Cloud
  • 涉及对象:UI 告警、事件报警器、弹性 IP、云主机网络、物理机网络。

问题现象

  • UI 展示物理机网卡失联类告警。
  • 客户按告警标题理解为物理机物理网卡异常。
  • 告警对象字段实际指向云主机绑定的弹性 IP 接口。

可能原因

  • 告警标题描述的是事件类型,而告警对象字段指向具体受影响资源。
  • 物理网络事件与云主机弹性 IP 资源存在绑定关系,导致客户从不同层级理解告警。
  • UI 文案或对象展示不够清晰,造成资源层级误解。
  • 产品对象映射或事件详情可能存在展示缺陷,需要进一步确认。

排查步骤

  1. 记录告警标题、告警对象名称、告警对象 uuid、resourceType 和触发时间。
  2. 打开告警详情或使用 API 确认 resourceUuid、resourceType、eventName。
  3. 根据弹性 IP 绑定关系反查云主机、VPC/扁平网络、物理网络和物理机网卡链路。
  4. 判断告警对象是否是受影响资源,还是展示字段映射错误。
  5. 如确认 UI 文案或对象映射不清晰,保留截图、事件详情和版本信息提交缺陷或优化。

解决方案

  • 排查时以事件详情中的 resourceUuid、resourceType、eventName 为准。
  • 向客户解释告警标题与实际对象之间的资源层级关系。
  • 如确认为 UI 展示问题,跟踪版本修复或提交产品优化。

验证方法

  • 能通过告警对象 uuid 定位到平台实际资源。
  • 能解释该资源与告警标题所描述事件之间的关联链路。
  • 客户确认告警对象口径或产品侧形成缺陷记录。

风险与回滚

  • 不要只按告警标题执行物理网络变更。
  • 涉及弹性 IP、VPC 或物理网络变更前需确认业务影响。

注意事项

  • 涉及管理服务、数据库、证书、权限、审计和安全配置调整时,应先确认 HA 状态、业务窗口、回退方案和合规保留要求。
  • 涉及管理网、存储网、业务网、DHCP/VNC、VLAN、bond、端口组或交换机侧配置时,应保留可用管理通道,并优先在维护窗口执行。
  • 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更,应联系 ZStack 官方技术支持确认后再执行。
ZStack Cloud UI 告警对象与实际资源不一致排查 | 故障排查 · KB | ZStack 资源中心