文档目录

问题说明

本文用于排查“短信通知内容截断 / 模板展示”类问题。

适用环境

  • 产品:ZCF
  • 版本:4.x、5.x
  • 组件:Cloud
  • 涉及对象:短信通知对象、告警模板、管理节点日志、短信服务商通道。
  • 场景:客户通过短信接收平台告警,并依赖短信内容定位资源。

问题现象

  • 短信告警能够正常发送。
  • 短信内容中的报警资源名称或字段被省略号截断。
  • 短信服务商反馈收到的平台侧原文已经包含省略号。
  • 管理节点日志中也能看到资源名称显示不完整。

可能原因

  • 平台侧生成短信内容时已经对资源名称做了截断。
  • 短信模板或后端字段长度限制导致内容被省略。
  • 短信服务商或终端展示限制导致客户侧看到内容不完整。
  • 资源名称过长,触发模板展示边界。

排查步骤

  1. 收集客户收到的短信原文、平台告警页面截图和管理节点日志中的发送内容。
  2. 向短信服务商确认实际收到的请求内容,判断截断发生在平台侧还是通道侧。
  3. 在管理节点日志中检索对应通知发送记录,确认平台发出的资源名称是否已经带省略号。
  4. 记录资源名称长度、告警模板、通知对象类型和 Cloud 版本。
  5. 如平台侧原文已被截断,按模板或产品缺陷处理。

关键命令

grep -a -nE "sms|SMS|Alarm|alarm|notification|notify" /usr/local/zstack/apache-tomcat/logs/management-server.log*

解决方案

  • 如果短信服务商收到的内容已经带省略号,跟踪平台模板或产品修复。
  • 必要时临时改用邮件或 HTTP 通知获取完整告警内容。
  • 资源名称过长时,可在客户接受的情况下优化命名规范。

验证方法

  • 管理节点日志中的发送内容包含完整资源名称。
  • 短信服务商收到的请求内容与平台日志一致。
  • 客户收到的短信能定位告警资源,或已通过其他通知方式补全详情。

风险与回滚

  • 仅凭客户手机截图无法判断截断层级。
  • 调整模板或通知方式前需确认客户告警接收流程。

注意事项

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