测量
From Senfi Docs
测量是用于表示可以源自设备或复杂系统的时间序列数据。
度量具有名称(用于显示)和代码(用于集成),并且由以下各项组成
- 时间戳
- 标签
- 参数
测量码
测量码是此测量的唯一标识符。您可以使用小写字母数字字符和下划线来组合测量码。
- 测量码的命名约定如下: <vendor>_<system>_<version>
- 例如: nest_thermostat_v1。如果您需要更改测量(例如,添加或删除参数),则应使用增量版本创建新测量,例如,nest_thermostat_v2。
测量码在创建后便无法更改。
时间戳
将测量结果发送到Senfi时,时间戳表示为tm_source,距离纪元以来的毫秒数。
请注意,时间戳是指进行读数或测量的时间,而不是指其发送的时间。在某些情况下,会先获取读数,然后再批量发送。在这种情况下,测量的时间戳会早于发送时间。
标签
标签就像是测量样本的属性。标签有两种类型:
- 强制性标签: 您可以将强制性标签视为数据库表中某一行的“组合键”。也就是说,强制性标签的组合将帮助您识别产生测量结果的传感器。
- 非强制性标签:非强制性标签可充当注释或标记的方式。
标记名称可以是小写字母数字字符和下划线的组合。标签值应作为字符串发送。标记值可以为空(""),但不能为null。
参数
这些可以是来自传感设备的原始值(例如rain_level),也可以是派生值(例如is_flooding)。 您可以决定在发送之前计算派生值,或将原始值发送到Senfi并利用计算的测量 来计算它。
与测量类似,每个参数都有一个名称(用于显示)和一个代码(用于集成)。您还应该为参数指定有效类型。
- 参数名:任何有效的文字(例如,Rain level)
- 参数码: 小写字母数字字符和下划线的组合(例如rain_level)
- 数据类型:以下之一:布尔值,浮点数,整数,字符串
参数类型在创建后便无法更改。