Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

将 Mist SLE 和洞察与 API 结合使用

当您使用瞻博网络 Mist 门户监控网络运行时,您可以在问题出现之前深入了解正在发生的情况。您可以从多个角度查看网络:无线、有线、WAN 和其他。此外,您还可以使用瞻博网络 Mist™ 提供的工具排除故障并更正潜在问题。

“监控>服务级别”中的主 Mist 仪表板以服务级别预期 (SLE) 指标的形式显示预测分析和关联引擎 (PACE) 的结果。SLE 利用机器学习和瞻博网络 Mist 云中的 Mist PACE。利用这些资源,SLE 将来自接入点 (AP) 的流遥测转换为近乎实时地代表最终用户网络体验的可视化效果。有关 SLE 的更多信息,请参阅瞻博网络 Mist AI 原生操作指南

与 Mist GUI 中看到的所有内容一样,SLE 和洞察信息也可从 API 获得。

系统性红斑狼疮 (SLE)

收集特定 SLE 的信息以用于历史报告目的或触发其他自动化可能对您有用。与其他 API 调用一样,您首先确定要从哪个终端节点收集数据。以下是终端节点的 getOrgsSitesSle API GET 请求示例:

有关更多信息,请参阅 SLE 概述

见解

洞察提供整个站点、接入点或无线客户端的网络体验概览。这是检查网站时的好起点。

您可以通过向以下见解终端节点之一发出 GET 请求来查找见解信息:

  • GetSiteInsightMetrics
  • GetSiteInsightMetricsForDevice
  • GetSiteInsightMetricsForClient

有关详细信息,请参阅 见解概述

指标和分类器

瞻博网络 Mist SLE 和洞察端点支持指标和分类器。指标跟踪服务级别是否满足配置的阈值。如果指标不符合阈值,则此故障可能归因于其中一个分类器,以进一步了解故障发生的位置。

SLE 和 Insights 端点通常需要参数 metric 。这是因为,除了原始统计信息或配置之外,Mist 还会公开内部数据分析产生的计算值。Mist 不是在每次添加新的数据分析功能时都创建唯一的 API 函数,而是只公开少数函数,但使用该参数指定 metric 要检索的派生数据值。

若要获取见解指标的列表,可以发出以下 GET 调用:

响应将如下所示:

查看可用 Insight 指标示例的另一种方法是登录 Mist 门户,然后从同一浏览器在新选项卡中打开此链接:

https://api.mist.com/api/v1/const/insight_metrics

使用前面的 GET 调用示例 GET /api/v1/const/insight_metrics,您将在调用结束时添加所需的指标。请参阅下面的示例 GET 调用,了解一些当前支持的指标及其分类器。

接入点正常运行时间: 接入点可用性

获取呼叫: 样品请求: 示例响应:
  • 接入点重启: 接入点重启
  • 接入点无法访问: 接入点无法访问
  • 站点关闭: 站点关闭

容量: 容量

获取呼叫: 样品请求: 示例响应:
  • 接入点负载: 接入点负载
  • 非无线网络干扰: 非无线网络干扰
  • 无线网络干扰: 无线网络干扰

覆盖范围: 覆盖范围

获取呼叫: 样品请求: 示例响应:
  • 非对称下行链路: 非对称下行链路
  • 非对称上行链路: 非对称上行链路
  • 弱信号: 弱信号

漫游: 漫游

获取呼叫: 样品请求: 示例响应:
  • 无法快速漫游: 无快速漫游
  • 慢速 11r 漫游: 次优-11r-漫游
  • 慢速 OKC 漫游: 次优-okc-roam
  • 慢速标准漫游: 慢速漫游

成功连接: 成功连接

获取呼叫: 样品请求: 示例响应:
  • 协会: 协会
  • 授权: 授权
  • DHCP: DHCP

吞吐量: 吞吐量

获取呼叫: 样品请求: 示例响应:
  • 容量: 容量
  • 覆盖范围: 覆盖范围
  • 设备功能: 设备功能
  • 网络问题: 网络问题

连接时间: 连接时间

获取呼叫:: 样品请求: 示例响应:
  • 协会: 协会
  • 授权: 授权
  • DHCP: DHCP
  • 互联网服务: IP 服务\u000C

计算系统性红斑狼疮百分比

SLE 指标成功率按在选定时间范围内达到阈值的频率的百分比计算。分类器也以百分比计算,但这些值指示它们对父故障的影响。

例如,下面的屏幕截图显示连接时间在 96% 的时间内成功;所有在下午 3:00-4:00 成功连接的客户端都在 4 秒阈值内完成了连接过程。

Success Rate on the Time to Connect Root Cause Analysis Page

此指标的成功率 (%) 派生自“指标摘要”API 终结点:

指标故障率的计算方法是将故障数 (sle.samples.degraded) 除以总数 (sle.samples.total)。然后将其转换为成功率百分比。使用上述 API 响应有效负载,计算将如下所示:

此屏幕截图显示了导致指标故障(DHCP、授权、关联和互联网服务)的分类器:

Example: Classifier Percentages

分类器的影响 (%) 派生自相同的“指标摘要”API 终结点:

分类器影响的计算方法是将分类器的失败(分类器[n].samples.degraded)除以所有失败(分类器[].samples.degraded)的总和。然后将其转换为百分比。使用上述 API 响应有效负载,DHCP 的计算如下所示:

监控系统性红斑狼疮

系统性红斑狼疮数据每十分钟更新一次。但是,在此粒度进行监视时,SLE 容易出现波动。因此,建议使用显式开始和结束时间查询 1 小时的间隔,并且每小时仅轮询一次。