排查工具
最近更新:2022-03-14

排查工具

排查工具包括消息查询和配额查询功能,通过查看消息的生命周期和厂商额度来判断消息是否正常下发,旨在帮助客户快速排查问题。

消息查询

推送收不到时,可以进入【极光控制台】-【极光推送】-【管理工具】-【排查工具】-【消息查询】页面进行生命周期排查。

输入 Message ID 和 Registration ID,点击查询即可查看消息的生命周期,查询结果如下图:

消息生命周期:如果发送失败,会在相应的失败环节展示错误码+错误提示信息。
特殊消息生命周期:如果消息类型为通知消息+自定义消息,则消息生命周期会产生两条分叉路径。
消息基本信息:展示消息类型、发送策略和消息体,点击消息体可以查看消息体 json。
设备基本信息:展示通知权限开关状态、厂商注册情况、最近在线时间等设备基本信息。

Message ID 获取方法

控制台获取

进入【极光控制台】-【消息推送】-【推送管理】-【推送记录】页面,即可获取 Message ID。

API 获取

API 调用后在应答参数中获取:

{ "sendno": "0", "msg_id": "54043471036732219" }
          {
    "sendno": "0",
    "msg_id": "54043471036732219"
}

        
此代码块在浮窗中显示

Registration ID 获取方法

客户端初始化 JPush 成功后,JPush 服务端会分配一个 Registration ID,作为此设备的标识(同一个手机不同 App 的 Registration ID 是不同的),因此排查时需要获取 Registration ID 定位问题,获取方法:AndroidiOS

配额查询

如果已经成功集成了厂商通道但推送没有走厂商通道时(VIP 默认推送策略为厂商通道优先),可以进入【极光控制台】-【消息推送】-【配置管理】-【排查工具】-【配额查询】页面,查看当前的厂商通道配额是否有剩余,若配额已全部消耗,当天的通知都将通过极光通道进行下发。

查询频率说明

厂商品牌 当日配额查询 最新余量(厂商)查询 实时余量(极光)计算逻辑
小米 支持,间隔 10min 查询并记录 支持,间隔 300s 查询并记录 最新余量-提交成功数量,30s 计算 1 次
OPPO 支持,间隔 10min 查询并记录 支持,间隔 300s 查询并记录 最新余量-提交成功数量,30s 计算 1 次
vivo 支持,间隔 10min 查询并记录 支持,间隔 300s 查询并记录 最新余量-提交成功数量,30s 计算 1 次
华为 不支持,当前未查询 不支持,当前未查询 不计算配额直接下发
魅族 不支持,当前未查询 不支持,当前未查询 不计算配额直接下发
华硕 不支持,当前未查询 不支持,当前未查询 不计算配额直接下发
FCM 不支持,当前未查询 不支持,当前未查询 不计算配额直接下发

设备查询

支持查询设备在线状态、注册到极光服务器的时间、通知开关状态、是否支持走厂商下发,以及厂商Token信息;可以进入【极光控制台】-【极光推送】-【管理工具】-【排查工具】-【设备查询】页面进行查询。

输入 Registration ID,点击查询即可查看设备信息,查询结果如下图:

文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开