通过 API 使用 Mist SLE 和洞察

SLE

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

注意：将 {org_id} 替换为您的组织 ID。

有关详细信息，请参阅 SLE 概述。

见解

洞察可以概括概述整个站点、接入点或无线客户端的网络体验。这是检查网站时的一个很好的起点。

您可以通过向以下 Insights 端点之一发出 GET 请求来查找 Insight 信息：

• GetSiteInsightMetrics
• GetSiteInsightMetricsForDevice
• GetSiteInsightMetricsForClient

有关更多信息，请参阅 见解概述。

指标和分类器

Juniper Mist SLE 和 Insights 端点支持指标和分类器。指标跟踪服务级别是否满足配置的阈值。如果指标未达到阈值，则此故障可归因于其中一个分类器，以进一步了解故障发生的位置。

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 调用。

AP 正常运行时间： AP 可用性

GET 呼叫：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• AP 重启： ap-reboot
• AP 不可访问： AP-unreachable
• 站点关闭： 站点关闭

容量： capacity

GET 调用：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 接入点负载： 接入点负载
• 非WiFi干扰： 非wifi干扰
• WiFi 干扰： wifi 干扰

覆盖范围： 覆盖范围

GET 调用：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 不对称下行链路： 不对称下行链路
• 非对称上行链路： asymmetry-uplink
• 弱信号： 弱信号

漫游： 漫游

GET 调用：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 无法快速漫游： 无快速漫游
• 慢速 11r 漫游： 次优-11r-roam
• OKC 漫游速度缓慢： 次优-okc-roam
• 标准漫游速度缓慢： 慢速漫游

成功连接： 成功连接

GET 调用：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 协会： association
• authorization： 授权
• DHCP： DHCP

吞吐量： 吞吐量

GET 调用：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 容量： capacity
• 覆盖范围： 覆盖范围
• 设备功能： 设备功能
• 网络问题： 网络问题

连接时间： 连接时间

获取电话：：

注意：将 {site_id} 替换为您的站点 ID。

请求示例： 示例响应：

• 协会： association
• authorization： 授权
• DHCP： DHCP
• 互联网服务： IP-Services\u000C

计算 SLE 百分比

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

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

此指标的成功率 （%） 派生自“指标摘要”API 终结点。

注意：将 site_id 替换为实际的站点 ID。

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

此屏幕截图显示了导致指标故障的分类器（DHCP、授权、关联和 Internet 服务）：

分类器的影响 （%） 来自同一个“指标摘要”API 端点。

注意：将 site_id 替换为实际的站点 ID。

分类器影响的计算方法是将分类器的故障 （classifiers[n].samples.degraded） 除以所有故障的总和 （classifiers[].samples.degraded）。然后将其转换为百分比。使用上述 API 响应有效负载，DHCP 的计算如下所示：

监控 SLE

SLE 数据每 10 分钟更新一次。但是，在这种粒度进行监控时，SLE 容易出现波动。因此，建议使用显式开始和结束时间查询 1 小时的间隔，并且每小时仅轮询一次。