文档

排查消息

更新时间:

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

操作步骤

  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,然后进行任务的下发,下发到厂商通道进行推送,成功推送后最终会显示到达。

image

推送异常时可以根据推送链路中的错误码或者报错信息来排查,错误码可以参考不同厂商的官方文档,如下图所示为鸿蒙官网的错误码,报错信息可以网上搜索相关的报错来解决。

image

image

4.查看设备信息

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

image

5.检查厂商通道

推送链路排查不出来问题时需要拿到厂商通道的token信息去厂商通道的平台里去排查,只输入消息ID时可以查询到绑定的前20台设备以及设备绑定的厂商token(如果有的话),一台手机绑定了多个厂商通道的话需要在排查设备页面拿设备ID去查询。

image