一、云排查介绍
开发者可以根据接口请求关键参数(如订单号),自助查询接口调用请求、同步返回以及异步通知等信息;结合云排查智能分析给出的问题排查建议和解决方案,快速定位解决问题、加快联调效率。
云排查功能逐步完善中,使用建议、问题以及需求请留言,我们会尽快处理!
云排查只支持查询正式环境相关数据,不支持查询沙箱环境相关数据。
产品特色
自助化:在线自助查询联调过程中的请求信息等日志。
智能化:智能的联调错误分析定位,快速、准确定位常见问题。
产品使用场景
适用接入联调过程碰到的如“签名错误”、“参数异常”、“异步通知收不到”等等常见错误。
产品入口
1. 云排查入口点击【查看】 。
2. 蚂蚁金服开放平台-->开发者中心-->技术支持-->自助工具-->云排查。
3. 蚂蚁技术支持图标-->联调日志排查。
二、云排查使用流程
1、登录开放平台
首先【点击登录】进入联调日志排查页面
注:必须要使用签约账号进行登录使用,如果是技术等相关人员操作必须由账号拥有人先在上方使用主账号到开放平台账户中心->员工子账号管理添加开发者管理员进行授权,填写真实的对应的支付宝账号把需要使用云排查的技术和相关同学添加进来。
2、选择查询服务
查询页面显示,可以看到有“服务”的查询条件,选择条件为2条。
1、异步通知问题排查:查询异步通知相关的数据信息。
2、请求返回错误问题排查:查询请求参数相关的数据信息。
3、请求返回错误问题排查
3.1、查询条件选择
(1)应用/PID:登录账户后,可选择账户名下创建的应用或者pid信息。
(2)请求关键字:可以设置为商户订单号或者接口英文名称等,(如支付接口的out_trade_no参数值,或者alipay.trade.pay)。
(3)请求时间:目前支持的查询日期是7天,所以在选择“开始日期”里,只能选择从当前日期往前的7天范围;
而“开始日期”里,可以选择对应“开始日期”的24小时内的所有时间段。
如下图:
3.2、查询结果说明
(1)请求成功,返回数据
(2)请求失败,返回数据
4、异步通知问题排查
注:由于这笔交易的异步地址外网无法访问,所以导致支付宝会持续返回异步,商户在查询的时候需要根据异步的通知时间去判断。
4.1、查询条件选择
(1)应用/PID:登录账户后,可选择账户名下创建的应用或者pid信息。
(2)交易号:交易成功后返回交易号,(如支付接口返回的trade_no)。
(3)请求时间:目前支持的查询日期是7天,所以在选择“开始日期”里,只能选择从当前日期往前的7天范围;
而“开始日期”里,可以选择对应“开始日期”的24小时内的所有时间段。
如下图:
4.2、查询结果说明
(1)商户接收异步通知成功,并返回success数据给支付宝。
http状态码:200,表示异步发送成功,商户端接收到异步成功。
返回:success,表示商户接收到异步返回的信息为success。
如果是返回信息为其他的,“返回”后显示商户返回的数据。
注:返回信息不是success,支付宝会重复发送异步通知(25小时内发送8次)。
(2)商户接收异步通知成功,并返回success数据给支付宝。
http状态码:405:发送状态,http状态码非200都表示商户端接收到异步存在问题。
“返回”后显示商户返回的数据。
注:返回信息不是success,支付宝会重复发送异步通知(25小时内发送8次,通知的间隔频率一般是:4m,10m,10m,1h,2h,6h,15h),商户可以重新接收异步通知,返回数据。
三、注意事项
1、请求时,为数据安全考虑,sign值脱敏,sign=***。
2、返回异步时,为数据安全考虑,sign和seller_email值脱敏,sign=$$$和seller_email=$$$。
商户实际请求的数据或者接收的异步通知为完整的信息,sign等参数存在完整的数据。
注:在查询结果下面有一个日志分析结果,在这里,可以对于异步信息返回的状态进行分析,找到问题的原因在哪里。