问题说明
本文用于排查“短信通知内容截断 / 模板展示”类问题。
适用环境
- 产品:ZCF
- 版本:4.x、5.x
- 组件:Cloud
- 涉及对象:短信通知对象、告警模板、管理节点日志、短信服务商通道。
- 场景:客户通过短信接收平台告警,并依赖短信内容定位资源。
问题现象
- 短信告警能够正常发送。
- 短信内容中的报警资源名称或字段被省略号截断。
- 短信服务商反馈收到的平台侧原文已经包含省略号。
- 管理节点日志中也能看到资源名称显示不完整。
可能原因
- 平台侧生成短信内容时已经对资源名称做了截断。
- 短信模板或后端字段长度限制导致内容被省略。
- 短信服务商或终端展示限制导致客户侧看到内容不完整。
- 资源名称过长,触发模板展示边界。
排查步骤
- 收集客户收到的短信原文、平台告警页面截图和管理节点日志中的发送内容。
- 向短信服务商确认实际收到的请求内容,判断截断发生在平台侧还是通道侧。
- 在管理节点日志中检索对应通知发送记录,确认平台发出的资源名称是否已经带省略号。
- 记录资源名称长度、告警模板、通知对象类型和 Cloud 版本。
- 如平台侧原文已被截断,按模板或产品缺陷处理。
关键命令
grep -a -nE "sms|SMS|Alarm|alarm|notification|notify" /usr/local/zstack/apache-tomcat/logs/management-server.log*
解决方案
- 如果短信服务商收到的内容已经带省略号,跟踪平台模板或产品修复。
- 必要时临时改用邮件或 HTTP 通知获取完整告警内容。
- 资源名称过长时,可在客户接受的情况下优化命名规范。
验证方法
- 管理节点日志中的发送内容包含完整资源名称。
- 短信服务商收到的请求内容与平台日志一致。
- 客户收到的短信能定位告警资源,或已通过其他通知方式补全详情。
风险与回滚
- 仅凭客户手机截图无法判断截断层级。
- 调整模板或通知方式前需确认客户告警接收流程。
注意事项
- 涉及管理服务、数据库、证书、权限、审计和安全配置调整时,应先确认 HA 状态、业务窗口、回退方案和合规保留要求。
- 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更,应联系 ZStack 官方技术支持确认后再执行。
