TimeSeries

一组描述指标随时间变化的值的数据点。时序由完全指定的受监控资源和完全指定的指标共同确定。此类型既用于列出时序,也用于创建时序。

JSON 表示法
{
  "metric": {
    object (Metric)
  },
  "resource": {
    object (MonitoredResource)
  },
  "metadata": {
    object (MonitoredResourceMetadata)
  },
  "metricKind": enum (MetricKind),
  "valueType": enum (ValueType),
  "points": [
    {
      object (Point)
    }
  ],
  "unit": string,
  "description": string
}
字段
metric

object (Metric)

关联的指标。用于标识时序的完整指定指标。

resource

object (MonitoredResource)

关联的受监控资源。自定义指标只能在其时序数据中使用某些受监控的资源类型。如需了解详情,请参阅自定义指标的受监控资源

metadata

object (MonitoredResourceMetadata)

仅限输出。关联的受监控资源元数据。读取时序时,此字段将包含在缩减中明确命名的元数据标签。创建时序时,系统会忽略此字段。

metricKind

enum (MetricKind)

时序的指标种类。 列出时序时,如果相应时序是对其他时序进行对齐或缩减的结果,则此指标种类可能与关联指标的指标种类不同。

创建时序时,此字段是可选字段。如果存在,则必须与关联指标的指标种类相同。如果必须自动创建关联指标的描述符,则此字段用于指定新描述符的指标种类,并且必须为 GAUGE(默认值)或 CUMULATIVE

valueType

enum (ValueType)

时序的值类型。 列出时序时,如果相应时序是对其他时序进行对齐或缩减的结果,则此值类型可能与关联指标的值类型不同。

创建时序时,此字段是可选字段。如果存在,则必须与 points 字段中的数据类型相同。

points[]

object (Point)

此时序的数据点。列出时序时,各点以反向时间顺序返回。

创建时序时,此字段必须仅包含一个点,并且该点的类型必须与关联指标的值类型相同。如果必须自动创建关联指标的描述符,则描述符的值类型由点的类型决定,该类型必须是 BOOLINT64DOUBLEDISTRIBUTION

unit

string

报告指标值时所用的单位。仅当 valueTypeINT64DOUBLEDISTRIBUTION 时适用。unit 用于定义存储的指标值的表示形式。此字段只能在为空时通过 CreateTimeSeries 进行更改。

description

string

仅限输入。与指标的 google.api.MetricDescriptor 关联的时序的详细说明。设置后,无法通过 CreateTimeSeries 更改此字段。