在此页面上
SLE API 文档
瞻博网络 Mist™ WiFi 服务级别仪表板上使用的许多端点都可以在 API 文档中找到： https://api.mist.com/api/v1/docs/Site#insights （需要有效登录） 或 https://api.ac2.mist.com/api/v1/docs/Site#insights。
下面介绍了在 API 文档中可能找不到的终结点。
指标/分类器
瞻博网络 Mist SLE 支持指标和分类器。指标跟踪服务级别是否满足配置的阈值。如果指标不符合阈值，则此故障可能归因于其中一个分类器，以进一步了解故障发生的位置。
当前支持的指标及其分类器如下所示：
接入点正常运行时间： 接入点可用性
- 接入点重启： 接入点重启
- 接入点无法访问： 接入点无法访问
- 站点关闭： 站点关闭
容量： 容量
- 接入点负载： 接入点负载
- 非无线网络干扰： 非无线网络干扰
- 无线网络干扰： 无线网络干扰
覆盖范围： 覆盖范围
- 非对称下行链路： 非对称下行链路
- 非对称上行链路： 非对称上行链路
- 弱信号： 弱信号
漫游： 漫游
- 无法快速漫游： 无快速漫游
- 慢速 11r 漫游： 次优-11r-漫游
- 慢速 OKC 漫游： 次优-okc-roam
- 慢速标准漫游： 慢速漫游
成功连接： 连接失败
- 协会： 协会
- 授权： 授权
- Dhcp： Dhcp
吞吐量： 吞吐量
- 容量： 容量
- 覆盖范围： 覆盖范围
- 设备功能： 设备功能
- 网络问题： 网络问题
连接时间： 连接时间
- 协会： 协会
- 授权： 授权
- Dhcp： Dhcp
- 互联网服务： IP 服务\u000C
API 端点
用户界面利用多个 API 端点来显示 SLE 数据。站点、AP 或客户端范围支持其中大多数终结点。
关键端点如下：
指标列表： 获取给定范围的指标列表
- 终结点： /api/v1/sites/：site_id/sle/scope/：scope_id/metrics
- site： /api/v1/sites/：site_id/sle/site/：site_id/metrics
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metrics
- 客户端： /api/v1/sites/：site_id/sle/client/：client_mac/metrics
指标阈值： 处理系统性红斑狼疮阈值
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/threshold
-
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/threshold
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/threshold
- 客户端： /api/v1/sites/：site_id/sle/client/：client_mac/metric/：metric/threshold
指标直方图： 获取 SLE 指标的直方图
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/直方图
-
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/直方图
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/直方图
- 客户端： /api/v1/sites/：site_id/sle/client/：client_mac/metric/：metric/直方图
- 参数：
- 开始 （即：1540591200）
- 结束 （即：1540594800）
指标摘要： 获取 SLE 指标的摘要
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/summary
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/summary
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/summary
- 客户端： /api/v1/sites/：site_id/sle/client/：client_mac/metric/：metric/summary
- 参数：
- 开始
- 结束\u000C
指标影响摘要： 获取影响摘要计数（可选）按分类器和故障类型筛选
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/impact-summary
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/impact-summary
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/impact-summary
- 参数：
- 开始
- 结束
- 字段=WLAN，device_type，device_os，频段
- 分类器=：分类器 （可选）
分类器摘要： 获取 SLE 分类器详细信息
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/classifier/：classifier/summary
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/classifier/：classifier/summary
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/classifier/：classifier/summary
- 参数：
- 开始
- 结束
受指标影响的接入点列表： 获取受影响的接入点（可选）按分类器和故障类型过滤
- EP （site）： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/impacted-aps
- 参数：
- 开始
- 结束
- 分类器=：分类器 （可选）
受影响的指标用户列表： 让受影响的用户有选择地按分类器和故障类型筛选
- EP： /api/v1/sites/：site_id/sle/：scope/：scope_id/metric/：metric/impacted-users
- site： /api/v1/sites/：site_id/sle/site/：site_id/metric/：metric/impacted-users
- AP： /api/v1/sites/：site_id/sle/ap/：ap_id/metric/：metric/impacted-users
- 参数：
-
- 开始
- 结束
- 分类器=：分类器 （可选）
计算系统性红斑狼疮百分比
SLE 指标成功率按在选定时间范围内达到阈值的频率的百分比计算。分类器也以百分比计算，但这些值指示它们对父故障的影响。
例如，下面的屏幕截图显示连接时间在 96% 的时间内成功;所有在下午 3：00-4：00 之间成功连接的客户端都在 4 秒阈值内完成了连接过程。
此指标的成功率 （%） 派生自“指标摘要”API 终结点：
/api/v1/sites/:site_id/sle/site/:site_id/metric/time-to-connect/summary?start=1540591200&end=1540594800
{
“start”: 1540591200,
“end”: 1540594800,
“sle”: {
“x_label”: “seconds”,
“y_label”: “seconds”,
“interval”: 600,
“name”: “time-to-connect”,
“samples”: {
“degraded”: [
0.0,
0.0,
3.0,
0.0,
3.0,
0.0
],
“total”: [
19.0,
14.0,
34.0,
8.0,
20.0,
43.0
]
}
}
}
指标故障率的计算方法是将故障数 （sle.samples.degraded） 除以总数 （sle.samples.total）。然后将其转换为成功率百分比。使用上述 API 响应有效负载，计算将如下所示：
ceil(1-[(0.0+0.0+3.0+0.0+3.0+0.0)/(19.0+14.0+34.0+8.0+20.0+43.0)])*100= ceil(1-[6/138])*100= ceil(1-0.04347826086)*100= ceil(0.95652173914)*100= 0.96*100= =96%
此屏幕截图显示了导致指标失败的分类器：
分类器的影响 （%） 派生自相同的“指标摘要”API 终结点：
/api/v1/sites/:site_id/sle/site/:site_id/metric/time-to-connect/summary?start=1540591200&end=1540594800
{
“start”: 1540591200,
“end”: 1540594800,
“classifiers”: [
{
“name”: “DHCP”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
1.0,
0
]
}
},
{
“name”: “authorization”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
0,
0
]
}
},
{
“name”: “association”,
“samples”: {
“degraded”: [
0,
0,
3.0,
0,
1.0,
0
]
}
},
{
“name”: “IP-Services”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
1.0,
0
]
}
}
]
}
分类器影响的计算方法是将分类器的失败（分类器[n].samples.degraded）除以所有失败（分类器[].samples.degraded）的总和。然后将其转换为百分比。使用上述 API 响应有效负载，DHCP 的计算如下所示：
ceil([0+0+0+0+1.0+0]/[(0+0+0+0+1.0+0)+(0+0+0+0+0+0)+(0+0+3.0+0+1.0+0)+(0+0+0+0+1.0+0)])*100= ceil(1/[1.0+0+4.0+1.0])*100= ceil(1/6)*100= ceil(0.16666666666)*100= 0.17*100= =17%
监控系统性红斑狼疮
SLE 数据每 10 分钟更新一次。但是，在此粒度进行监视时，SLE 容易出现波动。因此，建议使用显式开始/结束时间查询 1 小时的间隔，并且每小时仅轮询一次。