Difference between revisions of "Measurement/zh-cn"
From Senfi Docs
(Created page with "=== 参数 ===") |
(Created page with "这些可以是来自传感设备的原始值(例如<tt>$rain_level</tt>),也可以是派生值(例如<tt>$is_flooding</tt>)。 您可以决定在发送之前计算派...") |
||
Line 25: | Line 25: | ||
=== 参数 === | === 参数 === | ||
− | + | <div class="mw-translate-fuzzy"> | |
+ | 这些可以是来自传感设备的原始值(例如<tt>rain_level</tt>),也可以是派生值(例如<tt>is_flooding</tt>)。 您可以决定在发送之前计算派生值,或将原始值发送到Senfi并利用[[Computed_measurement|计算的测量]] 来计算它。 | ||
+ | </div> | ||
Similar to measurement, each metric has a ''name'' (for display), and a ''code'' (for integration). You should also specify a valid type for the metric. | Similar to measurement, each metric has a ''name'' (for display), and a ''code'' (for integration). You should also specify a valid type for the metric. |
Revision as of 12:23, 31 October 2019
测量是用于表示可以源自设备或复杂系统的时间序列数据。
度量具有名称(用于显示)和代码(用于集成),并且由以下各项组成
- 时间戳记
- 标签
- 参数
测量码
测量码是此测量的唯一标识符。您可以使用小写字母数字字符和下划线来组合测量码。
- 测量码的命名约定如下: <vendor>_<system>_<version>
- 例如: nest_thermostat_v1。如果您需要更改测量(例如,添加或删除参数),则应使用增量版本创建新测量,例如,nest_thermostat_v2。
测量码在创建后便无法更改。
时间戳记
将测量结果发送到Senfi时,时间戳记表示为tm_source,距离纪元以来的毫秒数。
请注意,时间戳是指进行读数或测量的时间,而不是指其发送的时间。在某些情况下,会先获取读数,然后再批量发送。在这种情况下,测量的时间戳会早于发送时间。
标签
标签就像是测量样本的属性。标签有两种类型:
- 强制性标签: 您可以将强制性标签视为数据库表中某一行的“组合键”。也就是说,强制性标签的组合将帮助您识别产生测量结果的传感器。
- 非强制性标签:非强制性标签可充当注释或标记的方式。
标记名称可以是小写字母数字字符和下划线的组合。标签值应作为字符串发送。标记值可以为空(""),但不能为null。
参数
这些可以是来自传感设备的原始值(例如rain_level),也可以是派生值(例如is_flooding)。 您可以决定在发送之前计算派生值,或将原始值发送到Senfi并利用计算的测量 来计算它。
Similar to measurement, each metric has a name (for display), and a code (for integration). You should also specify a valid type for the metric.
- Name
- Any valid text (eg. Rain level)
- Code
- Combination of lowercase alphanumeric characters and underscore (eg. rain_level)
- Type
- One of the following: boolean, float, integer, string
Metric type cannot be changed after creation