消息详情与转发记录说明
位置:消息管理 -> 详情抽屉(发送详情 / 转发详情)
基础字段含义
- 接收号码:收到短信的号码(目标 SIM)。
- 来源设备:上报该短信的设备 IMEI。
- 接收时间:设备侧记录的接收时间。
- 服务器接收:平台收到并落库的时间。
- 端到端延迟:从设备接收到平台入库的耗时。
- 短信内容:完整原文,可复制。
转发记录区域
每一条转发记录代表“某条规则 + 某个通道”的一次执行结果。
状态标签
发送成功:请求发送并被通道确认成功。发送失败:请求发送失败,可按策略补发。规则过滤:命中过滤逻辑,不进入发送流程。
记录字段
- 通道类型 / 通道名称:当前执行使用的通知渠道。
- 接收时间:该短信被系统接收的时间。
- 完成时间:该次转发任务结束时间。
- 耗时:当前转发记录总耗时。
- 重试次数:该记录重试计数。
- 错误信息:失败时返回的错误原因(如有)。
调试信息
- 每条转发记录右下角有“调试信息”按钮(虫子图标)。
- 点击后可查看本次转发的请求调试 JSON,包含:
url:转发请求 URL。reqObj:发送给目标通道的请求参数。resObj:通道返回的响应参数。- 规则过滤场景也会记录调试信息,便于判断是“未发送”还是“发送失败”。
“转发记录命中规则”说明
在详情中,转发记录的出现与状态可帮助判断规则命中情况:
- 出现
规则过滤 - 含义:规则已被评估,但该短信不满足发送条件(或被排除条件命中)。
- 结论:规则流程已命中到“过滤判定”,但未进入发送。
- 出现
发送成功/发送失败 - 含义:规则条件已命中,并已进入通道发送阶段。
- 结论:规则“命中并执行”。
- 同一短信有多条记录
- 含义:可能命中多条转发规则,或同一规则下多个通道。
- 结论:按每条记录独立判断状态和耗时。
- 有重试子记录
- 含义:首次失败后触发了补发/重试流程。
- 结论:可结合“重试次数”和子记录结果判断最终送达情况。
排障建议
1. 先看是否有对应转发记录:没有记录通常表示未进入规则执行链路。
2. 若为 规则过滤:重点检查匹配字段、匹配模式、匹配值。
3. 若为 发送失败:查看错误信息与通道可用性,再尝试补发。
4. 若多次失败:检查目标通道鉴权、限流、网络连通性。
---
消息详情与转发排障:底层流转的黑匣子
📍 位置: 消息管理 -> 详情抽屉(发送详情 / 转发详情)
💡 功能概要: 当您需要追溯某条短信“去哪儿了”时,这里提供最详尽的雷达追踪。您可以清晰看到这条短信触发了哪些规则、推向了哪个通道、以及最终是否送达成功。
🛠️ 状态标签与执行诊断
详情页展示了短信的完整原文和端到端延迟。最核心的是底部的“转发记录区域”,每一条记录代表了一次“规则+通道”的执行结果:
* ✅ 发送成功: 规则命中,且请求已成功发送并被目标通道确认。
* 🛑 规则过滤: 规则引擎已评估此短信,但由于内容不满足您的过滤条件,因此未进入发送流程。
* ❌ 发送失败: 规则已命中并尝试发送,但被目标通道拒绝或网络出错,系统会按策略尝试补发。
💡 排障与调试建议:
* 如果连记录都没有,说明短信完全没有触发任何规则的执行链路。
* 记录右下角有一个“虫子图标”(调试信息按钮),点击可查看最底层的 JSON 请求参数(reqObj)、目标 URL 和通道的响应数据(resObj)。
* 如果频繁出现“发送失败”,请结合错误信息,优先检查目标通道的鉴权秘钥、限流策略或网络连通性。