Package google.monitoring.v3

索引

• Point（消息）
• TimeInterval（消息）
• TimeSeries（消息）
• TypedValue（消息）

点

时序中的单个数据点。

字段
interval	TimeInterval 数据点适用的时间间隔。对于 GAUGE 指标，开始时间是可选的，但如果提供，则必须等于结束时间。对于 DELTA 指标，开始时间和结束时间应指定一个非零间隔，后续点指定连续和非重叠的间隔。对于 CUMULATIVE 指标，开始时间和结束时间应指定一个非零间隔，后续点指定相同的开始时间并增加结束时间，直到事件将累积值重置为零，并为以下各点设置新的开始时间。
value	TypedValue 数据点的值。

TimeInterval

一个时间区间，从开始时间之后一直延伸到结束时间。如果开始时间与结束时间相同，则该时间间隔表示单个时间点。

字段
end_time	Timestamp 必需。时间间隔的结束时间。
start_time	Timestamp 可选。时间区间的开始时间。开始时间的默认值为结束时间。开始时间不得晚于结束时间。

TimeSeries

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

字段
metric	Metric 关联的指标。用于标识时序的完整指定指标。
resource	MonitoredResource 关联的受监控的资源。自定义指标只能在其时序数据中使用某些受监控的资源类型。如需了解详情，请参阅自定义指标的受监控资源。
metadata	MonitoredResourceMetadata 仅限输出。关联的受监控的资源元数据。读取时序时，此字段将包含在缩减中明确命名的元数据标签。创建时序时，系统会忽略此字段。
metric_kind	MetricKind 时序的指标种类。列出时序时，如果相应时序是对其他时序进行对齐或缩减的结果，则此指标种类可能与关联指标的指标种类不同。 创建时序时，此字段是可选字段。如果存在，则必须与关联指标的指标种类相同。如果必须自动创建关联指标的描述符，则此字段用于指定新描述符的指标种类，并且必须为 GAUGE（默认值）或 CUMULATIVE。
value_type	ValueType 相应时序的值类型。列出时序时，如果相应时序是对其他时序进行对齐或缩减的结果，则此值类型可能与关联指标的值类型不同。 创建时序时，此字段是可选字段。如果存在，则必须与 points 字段中的数据类型相同。
points[]	Point 此时序的数据点。列出时序时，各点以反向时间顺序返回。 创建时序时，此字段必须仅包含一个点，并且该点的类型必须与关联指标的值类型相同。如果必须自动创建关联指标的描述符，则描述符的值类型由点的类型决定，该类型必须是 BOOL、INT64、DOUBLE 或 DISTRIBUTION。
unit	string 报告指标值时所用的单位。仅当 value_type 为 INT64、DOUBLE 或 DISTRIBUTION 时适用。unit 用于定义存储的指标值的表示形式。此字段只能在为空时通过 CreateTimeSeries 进行更改。
description	string 仅限输入。与指标的 google.api.MetricDescriptor 关联的时序的详细说明。设置后，无法通过 CreateTimeSeries 更改此字段。

TypedValue

单个强类型值。

字段
联合字段 value。类型值字段。value 只能是下列其中一项：
bool_value	bool 布尔值：true 或 false。
int64_value	int64 64 位整数。其范围约为 ±9.2x10^18。
double_value	double 64 位双精度浮点数。其量级约为 ±10^±300，精度为 16 个有效位。
string_value	string 长度可变的字符串值。
distribution_value	Distribution 一个分布值。