Record - Amazon Timestream

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics,可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间,以实现实时分析。点击此处了解更多信息。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Record

表示将写入 Timestream 的时间序列数据点。每条记录均包含维度数组。维度表示时间序列数据点的元数据属性,例如 EC2 实例的实例名称或可用区。记录还包含度量名称,即正在收集的度量名称(例如,EC2 实例的 CPU 利用率)。此外,记录还包含度量值及值类型,即度量值的数据类型。此外,记录包含收集度量的时间戳及时间戳单位,后者表示时间戳的粒度。

记录包含 Version 字段,该字段是 64 位 long,可用于更新数据点。写入具有相同维度、时间戳和度量名称但度量值不同的重复记录时,仅当写入请求中记录的 Version 属性高于现有记录时才会成功。对于没有 Version 字段的记录,Timestream 默认使用 1Version

内容

Dimensions

包含时间序列数据点的维度列表。

类型:Dimension 对象数组

数组成员:最多 128 项。

必需:否

MeasureName

度量表示时间序列的数据属性。例如,EC2 实例的 CPU 利用率或风力涡轮机的 RPM 都是度量。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

MeasureValue

包含时间序列数据点的度量值。

类型:字符串

长度限制:最小长度为 0。最大长度为 2048。

必需:否

MeasureValues

包含时间序列数据的 MeasureValue 列表。

这仅限于类型 MULTI。对于标量值,直接使用记录的 MeasureValue 属性。

类型:MeasureValue 对象数组

必需:否

MeasureValueType

包含时间序列数据点的度量值数据类型。默认类型为 DOUBLE。有关更多信息,请参阅数据类型

类型:字符串

有效值:DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

必需:否

Time

包含收集数据点度量值的时间。时间值加上单位即为自 epoch 以来经过的时间。例如,如果时间值为 12345,单位为 ms,则自 epoch 以来已经过 12345 ms

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

TimeUnit

时间戳单位的粒度。这指示时间值的单位是秒、毫秒、纳秒还是其他支持的值。默认值为 MILLISECONDS

类型:字符串

有效值:MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

必需:否

Version

用于更新记录的 64 位属性。具有更高版本号的重复数据写入请求将更新现有度量值和版本。如果度量值相同,Version 仍会进行更新。默认值为 1

注意

Version 必须等于或大于 1,否则将收到 ValidationException 错误。

类型:长整型

必需:否

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: