排查工具
排查工具包括消息查询和配额查询功能,通过查看消息的生命周期和厂商额度来判断消息是否正常下发,旨在帮助客户快速排查问题。
消息查询
推送收不到时,可以进入【极光控制台】-【极光推送】-【管理工具】-【排查工具】-【消息查询】页面进行生命周期排查。
输入 Message ID 和 Registration ID,点击查询即可查看消息的生命周期,查询结果如下图:
消息生命周期:如果发送失败,会在相应的失败环节展示错误码+错误提示信息。
特殊消息生命周期:如果消息类型为通知消息+自定义消息,则消息生命周期会产生两条分叉路径。
消息基本信息:展示消息类型、发送策略和消息体,点击消息体可以查看消息体 json。
设备基本信息:展示通知权限开关状态、厂商注册情况、最近在线时间等设备基本信息。
Message ID 获取方法
控制台获取
进入【极光控制台】-【消息推送】-【推送管理】-【推送记录】页面,即可获取 Message ID。
API 获取
API 调用后在应答参数中获取:
{
"sendno": "0",
"msg_id": "54043471036732219"
}
Registration ID 获取方法
客户端初始化 JPush 成功后,JPush 服务端会分配一个 Registration ID,作为此设备的标识(同一个手机不同 App 的 Registration ID 是不同的),因此排查时需要获取 Registration ID 定位问题,获取方法:Android、iOS。
配额查询
如果已经成功集成了厂商通道但推送没有走厂商通道时(VIP 默认推送策略为厂商通道优先),可以进入【极光控制台】-【消息推送】-【配置管理】-【排查工具】-【配额查询】页面,查看当前的厂商通道配额是否有剩余,若配额已全部消耗,当天的通知都将通过极光通道进行下发。
查询频率说明
厂商品牌 | 当日配额查询 | 最新余量(厂商)查询 | 实时余量(极光)计算逻辑 |
---|---|---|---|
小米 | 支持,间隔 10min 查询并记录 | 支持,间隔 300s 查询并记录 | 最新余量-提交成功数量,30s 计算 1 次 |
OPPO | 支持,间隔 10min 查询并记录 | 支持,间隔 300s 查询并记录 | 最新余量-提交成功数量,30s 计算 1 次 |
vivo | 支持,间隔 10min 查询并记录 | 支持,间隔 300s 查询并记录 | 最新余量-提交成功数量,30s 计算 1 次 |
华为 | 不支持,当前未查询 | 不支持,当前未查询 | 不计算配额直接下发 |
魅族 | 不支持,当前未查询 | 不支持,当前未查询 | 不计算配额直接下发 |
华硕 | 不支持,当前未查询 | 不支持,当前未查询 | 不计算配额直接下发 |
FCM | 不支持,当前未查询 | 不支持,当前未查询 | 不计算配额直接下发 |
设备查询
支持查询设备在线状态、注册到极光服务器的时间、通知开关状态、是否支持走厂商下发,以及厂商Token信息;可以进入【极光控制台】-【极光推送】-【管理工具】-【排查工具】-【设备查询】页面进行查询。
输入 Registration ID,点击查询即可查看设备信息,查询结果如下图: