测量

From Senfi Docs
Jump to: navigation, search
This page is a translated version of the page Measurement and the translation is 100% complete.

测量是用于表示可以源自设备或复杂系统的时间序列数据。

度量具有名称(用于显示)和代码(用于集成),并且由以下各项组成

  • 时间戳
  • 标签
  • 参数

测量码

测量码是此测量的唯一标识符。您可以使用小写字母数字字符和下划线来组合测量码。

  • 测量码的命名约定如下: <vendor>_<system>_<version>
  • 例如: nest_thermostat_v1。如果您需要更改测量(例如,添加或删除参数),则应使用增量版本创建新测量,例如,nest_thermostat_v2
测量码在创建后便无法更改。

时间戳

将测量结果发送到Senfi时,时间戳表示为tm_source,距离纪元以来的毫秒数。

请注意,时间戳是指进行读数或测量的时间,而不是指其发送的时间。在某些情况下,会先获取读数,然后再批量发送。在这种情况下,测量的时间戳会早于发送时间。

标签

标签就像是测量样本的属性。标签有两种类型:

强制性标签: 您可以将强制性标签视为数据库表中某一行的“组合键”。也就是说,强制性标签的组合将帮助您识别产生测量结果的传感器。
非强制性标签:非强制性标签可充当注释或标记的方式。

标记名称可以是小写字母数字字符和下划线的组合。标签值应作为字符串发送。标记值可以为空(""),但不能为null

参数

这些可以是来自传感设备的原始值(例如rain_level),也可以是派生值(例如is_flooding)。 您可以决定在发送之前计算派生值,或将原始值发送到Senfi并利用计算的测量 来计算它。

与测量类似,每个参数都有一个名称(用于显示)和一个代码(用于集成)。您还应该为参数指定有效类型。

参数名:任何有效的文字(例如,Rain level
参数码: 小写字母数字字符和下划线的组合(例如rain_level
数据类型:以下之一:布尔值,浮点数,整数,字符串
参数类型在创建后便无法更改。

下一页:规则