# 网络云排查工具安装指引 ## 一、功能简介 网络云排查工具，是微信支付推出的面向商户的一项拓展能力增值服务，旨在为商户使用微信支付业务过程中进行网络情况的跟踪与定位，一旦商户网络出现问题的时候可以及时发现和解决问题，为商户更好的运营微信支付业务提供保障。 ## 二、使用流程 ① **安装网络工具** 目前网络工具仅支持linux系统的安装与使用，支持windows系统的网络工具正在抓紧开发中，安装指引可以参照下文“微信支付网络工具安装指引”。 ② **订阅告警通知（暂未上线，请直接操作第三步）** ③**前往网络云排查工具主页**  成功安装网络云排查工具后，等待约15分钟左右，数据即可同步至商户平台，请适时前往“商户平台-数据中心-网络云排查工具”查看。 ## 三、微信支付网络工具安装指引 **1****、安装说明** 监控程序有两种工作模式：【常驻后台运行】、【一次性检查】。 如果您对程序的逻辑与性能存在疑虑，请查看文档最后的附录“程序逻辑简介”。 **2****、常驻后台运行** 2.1获取程序包 在“商户平台\-数据中心\-网络云排查工具”下载安装包，并上传到服务器 2.2解压程序包 命令：tar -xvzf wxpaymonitor.tar.gz 2.3启动程序 使用service.sh脚本启动程序。 命令：./service.sh start 2.4过3分钟后，确认程序正常运行 grep "Monitor report succ" log/mchagent\_log  出现Monitor report succ则表示运行正常 **3****、一次性检查** ./wxpaymonitor –t 对微信支付API服务进行一次性检查。 包含：接口网络耗时；获取LocalDns；测试微信支付服务器延时。 如下图所示：  图中各字段解释如下表所示：  #### 4、其他功能 运行./wxpaymonitor -h，可以查看所有命令参数，如下图：  4.1命令：./wxpaymonitor -i 展示程序的关键配置信息。 微信支付技术人员可能会要求您提供输出信息的前两行，以便在管理系统中能够查询到您的数据，如图所示：  4.2命令：./wxpaymonitor -u 检测更新。 只提示是否存在新版本，不会自动进行更新操作。考虑到您可能对自动更新存在顾虑，所以没有实现自动更新的功能。您可以联系微信支付技术人员，获取最新版本。 #### 5、附录一：程序逻辑简 监控程序使用golang编写，程序常驻后台运行时，会做三件事。 5.1对微信支付API发起一次GET请求 请求API是微信支付查单接口，https://api.mch.weixin.qq.com/pay/orderquery。通过发起一次GET请求，获取：域名解析耗时；connect耗时；域名解析IP列表。 5.2对一个随机域名发起一次域名解析 随机域名是\*\*\*\*.mmpay.imtmp.net，这个特定的域名解析时，最终会递归到腾讯的DNS根服务器，根服务器会拿到用户的LocalDns。 5.3 Ping测试api.mch.weixin.qq.com解析出的IP 对解析出的IP列表发送ICMP包，三次探测取平均值，得到ping测延时。 监控的结果会进行上报，上报地址为：https://api.mch.weixin.qq.com/opitil/mReport。微信支付内部提供管理平台对数据进行分析、绘图，辅助技术人员定位问题。 程序定时每分钟运行一次。 做一次性检查时，程序逻辑基本类似，只是将检测结果输出到控制台。 #### 6、附录二：程序目录结构 bin --- 工具脚本目录 data --- 数据文件目录 etc --- 配置文件目录 log --- 日志目录 service.sh --- 启停脚本 wxpaymonitor --- 程序二进制