Difference between revisions of "Measurement/zh-cn"
From Senfi Docs
(Created page with "这些可以是来自传感设备的原始值（例如<tt>$rain_level</tt>)，也可以是派生值（例如<tt>$is_flooding</tt>)。 您可以决定在发送之前计算派...") |
|||
| (7 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
度量具有''名称''（用于显示）和''代码''（用于集成），并且由以下各项组成 | 度量具有''名称''（用于显示）和''代码''（用于集成），并且由以下各项组成 | ||
| − | * | + | * 时间戳 |
* 标签 | * 标签 | ||
* 参数 | * 参数 | ||
| Line 11: | Line 11: | ||
* 例如： <tt>nest_thermostat_v1</tt>。如果您需要更改测量（例如，添加或删除参数），则应使用增量版本创建新测量，例如，<tt>nest_thermostat_v2</tt>。 | * 例如： <tt>nest_thermostat_v1</tt>。如果您需要更改测量（例如，添加或删除参数），则应使用增量版本创建新测量，例如，<tt>nest_thermostat_v2</tt>。 | ||
<div class="important">测量码在创建后便无法更改。</div> | <div class="important">测量码在创建后便无法更改。</div> | ||
| − | === | + | === 时间戳 === |
| − | + | 将测量结果发送到Senfi时，时间戳表示为<tt>tm_source</tt>，距离纪元以来的毫秒数。 | |
请注意，时间戳是指进行读数或测量的时间，而不是指其发送的时间。在某些情况下，会先获取读数，然后再批量发送。在这种情况下，测量的时间戳会早于发送时间。 | 请注意，时间戳是指进行读数或测量的时间，而不是指其发送的时间。在某些情况下，会先获取读数，然后再批量发送。在这种情况下，测量的时间戳会早于发送时间。 | ||
| Line 25: | Line 25: | ||
=== 参数 === | === 参数 === | ||
| − | + | 这些可以是来自传感设备的原始值（例如<tt>rain_level</tt>），也可以是派生值（例如<tt>is_flooding</tt>）。 您可以决定在发送之前计算派生值，或将原始值发送到Senfi并利用[[Computed_measurement/zh-cn|计算的测量]] 来计算它。 | |
| − | 这些可以是来自传感设备的原始值（例如<tt>rain_level</tt> | ||
| − | |||
| − | + | 与测量类似，每个参数都有一个''名称''（用于显示）和一个''代码''（用于集成）。您还应该为参数指定有效类型。 | |
| − | ; | + | ; 参数名：任何有效的文字（例如，''Rain level''） |
| − | ; | + | ; 参数码： 小写字母数字字符和下划线的组合（例如<tt>rain_level</tt>） |
| − | ; | + | ; 数据类型：以下之一：布尔值，浮点数，整数，字符串 |
| − | <div class="important"> | + | <div class="important">参数类型在创建后便无法更改。</div> |
| − | <span class="right">[[Rule| | + | <span class="right">[[Rule/zh-cn|下一页：规则]]</span> |
Latest revision as of 17:02, 20 November 2019
测量是用于表示可以源自设备或复杂系统的时间序列数据。
度量具有名称（用于显示）和代码（用于集成），并且由以下各项组成
- 时间戳
- 标签
- 参数
测量码
测量码是此测量的唯一标识符。您可以使用小写字母数字字符和下划线来组合测量码。
- 测量码的命名约定如下： <vendor>_<system>_<version>
- 例如： nest_thermostat_v1。如果您需要更改测量（例如，添加或删除参数），则应使用增量版本创建新测量，例如，nest_thermostat_v2。
测量码在创建后便无法更改。
时间戳
将测量结果发送到Senfi时，时间戳表示为tm_source，距离纪元以来的毫秒数。
请注意，时间戳是指进行读数或测量的时间，而不是指其发送的时间。在某些情况下，会先获取读数，然后再批量发送。在这种情况下，测量的时间戳会早于发送时间。
标签
标签就像是测量样本的属性。标签有两种类型：
- 强制性标签： 您可以将强制性标签视为数据库表中某一行的“组合键”。也就是说，强制性标签的组合将帮助您识别产生测量结果的传感器。
- 非强制性标签：非强制性标签可充当注释或标记的方式。
标记名称可以是小写字母数字字符和下划线的组合。标签值应作为字符串发送。标记值可以为空（""），但不能为null。
参数
这些可以是来自传感设备的原始值（例如rain_level），也可以是派生值（例如is_flooding）。 您可以决定在发送之前计算派生值，或将原始值发送到Senfi并利用计算的测量 来计算它。
与测量类似，每个参数都有一个名称（用于显示）和一个代码（用于集成）。您还应该为参数指定有效类型。
- 参数名：任何有效的文字（例如，Rain level）
- 参数码： 小写字母数字字符和下划线的组合（例如rain_level）
- 数据类型：以下之一：布尔值，浮点数，整数，字符串
参数类型在创建后便无法更改。