帮助开发者在推送出现异常情况(如推送失败)时进行自助排查。
操作步骤
登录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,然后进行任务的下发,下发到厂商通道进行推送,成功推送后最终会显示到达。
推送异常时可以根据推送链路中的错误码或者报错信息来排查,错误码可以参考不同厂商的官方文档,如下图所示为鸿蒙官网的错误码,报错信息可以网上搜索相关的报错来解决。
4.查看设备信息
通过设备ID可以在排查设备页面查看设备的信息,排查是否设备信息设置错误导致,比如通知栏没有打开导致推送成功但手机上没有提示等,如果推送消息只推送了一台手机,设备信息会直接显示在当前页面上,如下图所示没有满足推送条件的设备。
5.检查厂商通道
推送链路排查不出来问题时需要拿到厂商通道的token信息去厂商通道的平台里去排查,只输入消息ID时可以查询到绑定的前20台设备以及设备绑定的厂商token(如果有的话),一台手机绑定了多个厂商通道的话需要在排查设备页面拿设备ID去查询。