云智慧支持中心

1、如何通过导入Postman中的脚本来添加API请求？

在监控宝中创建API监控时，您可以通过导入Postman脚本来添加API请求。开始前，请您安装Chrome浏览器的Postman插件。

1）添加请求

打开Postman，选择请求方式并输入请求URL，根据需要设置相关参数等，如下图所示。

2）发送请求

设置完成后，点击<Send>按钮发送请求，发送成功后返回请求结果，如下图所示。

3）添加到collection

得到正确的返回结果后，点击<Add to collection>按钮，将当前请求添加到一个请求集合中，如下图所示。

您可以在一个集合中添加多个请求，这样在导入脚本时能一次导入所有请求。但为避免出现格式错误，不建议同时导入多个集合的数据。

4）下载数据

点击上方的<Download all data>按钮，下载集合中所有请求的数据，复制从id属性到version属性的完整内容（中括号除外），如下图所示。

5）导入脚本

在创建API监控项目的请求管理页面中，点击<导入脚本>按钮，粘贴在Postman中复制的数据，导入后自动生成对应的API请求，如下图所示。

这样就完成了通过Postman脚本导入API请求的操作，导入请求时会同时导入请求参数，您可以继续设置API请求的断言、认证、变量等。

2、如何判断API请求成功？

API请求，请求返回码为1XX、2XX或3XX时，都视为请求成功。

API事务，其所有请求都成功时，则视为成功；否则返回其顺序请求的第一个非成功码（1XX、2XX、3XX之外的返回码）。

API请求未设置断言时，请求返回码默认为200（请求成功）。

3、如何判断请求的可用性和正确性？

根据监测的数量，请求的可用性和正确性的判断标准如下：

可用性

单监测点：一次监测，返回状态码为1XX、2XX或3XX则为可用，否则为故障。

多监测点：一次监测，所有监测点都可用，则为全部可用；部分监测点可用，则为部分可用；所有监测点都不可用，则为故障。

正确性

单监测点：一次监测，断言正确则为正确，否则为错误。

多监测点：一次监测，所有监测点的断言都正确，则为全部正确；部分监测点的断言正确，则为部分正确；所有监测点的断言都不正确，则为错误。

4、如何判断事务的可用性和正确性？

根据监测点的数量，请求的可用性和正确性的判断标准如下：

可用性

单监测点：一次监测，事务的所有请求都可用才为可用，否则为故障。

多监测点：一次监测，所有监测点都可用，则为全部可用；部分监测点可用，则为部分可用；所有监测点都不可用，则为故障。

正确性

单监测点：一次监测，事务的所有请求都正确才为正确，否则为错误。

多监测点：一次监测，所有监测点都正确，则为全部正确；部分监测点正确，则为部分正确；所有监测点的请都不正确，则为错误。

5、如何计算API监控的各项指标？

API监控中，各项指标的计算规则如下表所示。

指标	规则
响应时间	请求：一次监测，请求结果返回的时间，包括DNS解析、建立连接、服务器计算、内容下载。（不可用、不正确的不计算）
响应时间	事务：一次监测，事务中所有请求的响应时间总和。（不可用、不正确的不计算）
可用率	请求：在单个监测点，请求可用率=请求可用次数/请求总次数
可用率	事务：在单个监测点，事务可用率=事务可用次数/事务总次数
故障率	请求：单个监测点，请求故障率=1-请求可用率
故障率	事务：单个监测点，事务故障率=1-事务可用率
正确率	请求：在单个监测点，请求正确率=请求正确次数/请求总次数
正确率	事务：在单个监测点，事务正确率=事务正确次数/事务总次数
平均可用率	请求：多个监测点，先计算每个监测点的请求可用率，然后取所有监测点请求可用率的平均值。
平均可用率	事务：多个监测点，先计算每个监测点的事务可用率，然后取所有监测点事务可用率的平均值。
平均正确率	请求：多个监测点，先计算每个监测点的请求正确率，然后取所有监测点请求正确率的平均值。
平均正确率	事务：多个监测点，先计算每个监测点的事务正确率，然后取所有监测点事务正确率的平均值。
平均响应时间	请求单监测点：一段时间内，某监测点、某请求响应时间的平均值。（不可用、不正确的不计算）多监测点：先计算每个监测点的请求响应时间的平均值，然后取所有监测点的平均值。（不可用、不正确的不计算）
平均响应时间	事务单监测点：一段时间内，某监测点、某事务响应时间的平均值。（不可用、不正确的不计算）多监测点：先计算每个监测点的事务响应时间的平均值，然后取所有监测点的平均值。（不可用、不正确的不计算）
错误总时长	单监测点：指定时间内，某监测点的错误总时长。多监测点：指定时间内，所有监测点错误总时长之和。
错误总次数	单监测点：指定时间内，某监测点的错误总次数。多监测点：指定时间内，所有监测点错误总次数之和。
故障总时长	单监测点：指定时间内，某监测点的故障总时长。多监测点：指定时间内，所有监测点故障总时长之和。
故障总次数	单监测点：指定时间内，某监测点的故障总次数。多监测点：指定时间内，所有监测点故障总次数之和。

6、如何监控用户登录后的页面是否能够正常打开？

您可以在API监控中通过多步请求来实现：

第一个请求完成用户登录，将cookie或是session设置到下一个请求头中。

将登录后的页面作为第二个请求，验证请求的返回状态码是不是200 OK，返回的页面内容是不是正确的。