预置指标是物联网数据服务平台默认描述设备情况的维度,预置指标表是一组预置指标的集合,指标数据默认是关闭统计的。您可开启预置指标表统计预置指标数据,并将预置指标表实例化为数据API,用于获取统计的指标数据。本文介绍如何查看预置指标表、开启统计指标数据和实例化API。
前提条件
已完成产品数据备份。具体操作,请参见数据备份。
计费说明
开启预置指标表统计相关指标数据,会消耗数据处理单元(CU)。具体内容,请参见数据服务计费说明。
查看预置指标表
在物联网平台控制台的实例概览页面,单击目标企业版实例ID或备注名称。
-
在左侧导航栏,选择数据服务 > 数据指标。
-
在预置指标页签,查看所有的预置指标表。
预置指标表包含以下列:指标名称、描述、CU消耗、调度类型、指标类型和操作。在操作列,可单击查看查看指标详情,或单击启用指标启用对应指标。页面顶部提供搜索框,可按指标名称搜索。
-
(可选)单击某预置指标表对应操作列的查看。
在指标表详情页面,查看该预置指标表的基本信息,以及构成该表的预置指标。查看页面展示指标表的基本信息,包括指标名(如
connectionSuccessRate)、表显示名(如 每分钟网络连接成功率)、字段数和类型(设备)。下方表结构区域列出各字段的名称、别名(中文名)和字段类型,例如字段metricValue,别名为 网络连接成功率,字段类型为double。
开启和关闭预置指标表统计数据
开启指定预置指标表的数据统计
-
在预置指标页签,单击目标预置指标对应操作列的启用指标。
-
在弹出的对话框,单击确认开启。
重要若当前实例的CU规格不足,弹出对话框会提示您升配实例规格。您需根据页面提示,完成CU规格升配。规格说明,请参见购买企业版实例。
完成升配后,您需参照以上操作开启指标数据统计。
弹窗显示当前可使用 CU 数及开启所需消耗的 CU。每月 CU 消耗量随设备数量变化而增减。离线指标采用 T+1 统计方式,开启后第二天可查看对应的统计结果。
关闭指定预置指标表的数据统计
-
在预置指标页签,单击目标预置指标对应操作列的停用指标。
-
在弹出的对话框,单击确认关闭。
关闭后指标不再继续统计,可随时开启。
生成预置指标数据API
开启预置指标表统计数据后,对应预置指标表会自动实例化生成数据API。您可以使用对应数据API获取该预置指标表统计的指标数据。
-
在预置指标页签,单击该预置指标表对应操作列的数据预览,可查看预置指标表统计的最近20条数据。在数据预览页面可查看该预置指标表的统计数据。以表任意时间段内每日设备在线时长统计为例,默认预览最新的20条数据,包含统计日期、最大在线时长、最小在线时长、平均在线时长、最大在线时长设备、最小在线时长设备等字段。
-
返回预置指标页签,单击该预置指标表对应操作列的数据API详情,可查看API基础信息和使用情况。
API详情与使用的具体内容,请参见管理与使用。基础信息包含API 名称、API Path、状态、创建时间、API 类型、调用次数、超时报错条件和最近一次调用等字段,同时可在API 监控区域切换API 运维和API 测试页签。