Difference between revisions of "Measurement/zh-cn"

From Senfi Docs
Jump to: navigation, search
(Created page with "=== 参数 ===")
(Created page with "这些可以是来自传感设备的原始值(例如<tt>$rain_level</tt>),也可以是派生值(例如<tt>$is_flooding</tt>)。 您可以决定在发送之前计算派...")
Line 25: Line 25:
 
=== 参数 ===
 
=== 参数 ===
  
These can be raw values from the sensing device (eg. <tt>rain_level</tt>), or derived values (eg. <tt>is_flooding</tt>). You can decide to compute the derived values before sending, or send the raw values to Senfi and make use of [[Computed_measurement|computed measurement]] to calculate it.
+
<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

Next: Rule