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 分布值。