排查消息

帮助开发者在推送出现异常情况(如推送失败)时进行自助排查。

操作步骤

  1. 登录EMAS管理控制台

  2. 查找您的项目,单击项目,进入EMAS概览页。

  3. 在顶部导航栏,选择用户增长

  4. 用户增长产品页面,从左侧导航栏单击排查工具

  5. 排查消息页签,输入消息ID(必选)、设备ID(可选),单击查询,查看消息详情。

    image

排查的流程通常涉及以下几个关键步骤,以帮助诊断和解决推送过程中的问题。下面是一个通用的排查的过程:

1. 消息ID

在OpenAPI的响应报文或者控制台的推送历史中,每一条消息都有对应的消息ID,输入您想要排查的消息ID就可以查询推送信息。

a. 消息ID和设备ID

想要查询指定手机上的消息推送时就需要用到设备的ID,输入消息ID和设备ID可以查询详细信息。

image

b. 消息ID

在不知道设备ID的情况下,可以通过消息ID查询到默认前20台的设备ID,再根据设备ID和消息ID来查询指定机型的推送信息。

image

2. 检查推送设备信息

推送信息里包含了这条推送的信息的一些配置信息,一些推送失败可能是由于推送的配置错误导致的,界面中标红的部分需要重点关注,可能是错配或不常见的配置,如下图所示中推送时设置的离线不保存,即只推在线导致无法推送到离线设备。

image

3. 查看推送链路

推送链路会显示从接收请求到推送完成的全过程,正常的推送流程如下图所示,接收到请求后会生成请求的ID,然后进行任务的下发,通过推送网关进行受理,再下发到具体的通道进行推送,推送的结果可能是推送成功,也可能是推送失败。客户端返回到达ACK或厂商通道返回到达回执则会显示到达。

image

推送异常时可以根据推送链路中的错误码或者报错信息来排查,可以参考移动推送厂商通道部分错误码和错误原因说明文档。

image

image

4.查看设备信息

通过设备ID可以在排查设备页面查看设备的信息,排查是否设备信息设置错误导致,比如通知栏没有打开导致推送成功但手机上没有提示等。如果推送消息只推送了一台设备,设备信息会直接显示在当前页面上,如下图所示没有满足推送条件的设备。

image

5.检查厂商通道

推送链路排查不出来问题时,需要拿到厂商通道的消息ID和设备token信息去厂商通道的平台里去排查,厂商通道的消息ID可从推送链路中推送成功或推送失败节点中查找,设备Token信息可从排查设备中查找。

image