帮助开发者在推送出现异常情况(如推送失败)时进行自助排查。
操作步骤
登录EMAS管理控制台。
查找您的项目,单击项目,进入EMAS概览页。
在顶部导航栏,选择用户增长。
在用户增长产品页面,从左侧导航栏单击排查工具。
排查消息页签,输入消息ID(必选)、设备ID(可选),单击查询,查看消息详情。
排查的流程通常涉及以下几个关键步骤,以帮助诊断和解决推送过程中的问题。下面是一个通用的排查的过程:
1. 消息ID
在OpenAPI的响应报文或者控制台的推送历史中,每一条消息都有对应的消息ID,输入您想要排查的消息ID就可以查询推送信息。
a. 消息ID和设备ID
想要查询指定手机上的消息推送时就需要用到设备的ID,输入消息ID和设备ID可以查询详细信息。
b. 消息ID
在不知道设备ID的情况下,可以通过消息ID查询到默认前20台的设备ID,再根据设备ID和消息ID来查询指定机型的推送信息。
2. 检查推送设备信息
推送信息里包含了这条推送的信息的一些配置信息,一些推送失败可能是由于推送的配置错误导致的,界面中标红的部分需要重点关注,可能是错配或不常见的配置,如下图所示中推送时设置的离线不保存,即只推在线导致无法推送到离线设备。
3. 查看推送链路
推送链路会显示从接收请求到推送完成的全过程,正常的推送流程如下图所示,接收到请求后会生成请求的ID,然后进行任务的下发,通过推送网关进行受理,再下发到具体的通道进行推送,推送的结果可能是推送成功,也可能是推送失败。客户端返回到达ACK或厂商通道返回到达回执则会显示到达。
推送异常时可以根据推送链路中的错误码或者报错信息来排查,可以参考移动推送厂商通道部分错误码和错误原因说明文档。
4.查看设备信息
通过设备ID可以在排查设备页面查看设备的信息,排查是否设备信息设置错误导致,比如通知栏没有打开导致推送成功但手机上没有提示等。如果推送消息只推送了一台设备,设备信息会直接显示在当前页面上,如下图所示没有满足推送条件的设备。
5.检查厂商通道
推送链路排查不出来问题时,需要拿到厂商通道的消息ID和设备token信息去厂商通道的平台里去排查,厂商通道的消息ID可从推送链路中推送成功或推送失败节点中查找,设备Token信息可从排查设备中查找。