资源:Anomaly
表示在数据集内检测到的异常值。
我们的异常值检测系统会标记出超出历史数据且根据历史数据得出的预期范围内的数据点。虽然这些预期范围有上限和下限,但只有在数据出现异常差时,我们才会标记出异常值(通常与指标超过上限的情况相对应)。
时间轴超出预期范围的多个连续数据点将划分为一个异常值。因此,异常值实际上代表了指标时间轴的一个细分。timelineSpec
、dimensions
和 metric
中存储的信息可用于提取扩展时间轴作为上下文的完整时间轴。
所需权限:要访问此资源,发起调用的用户必须对相应应用拥有查看应用信息(只读)权限。
JSON 表示法 |
---|
{ "name": string, "metricSet": string, "timelineSpec": { object ( |
字段 | |
---|---|
name |
异常值的名称。 格式:apps/{app}/anomalies/{anomaly} |
metricSet |
检测到异常值的指标集资源。 |
timelineSpec |
涵盖异常情况的时间轴规范。 |
dimensions[] |
检测到异常值的维度组合。 |
metric |
检测到异常值的指标以及异常值。 |
时间轴规范
时间轴的时间相关聚合参数的规范。
时间轴有一个汇总时间段(DAILY
、HOURLY
等),用于定义指标的汇总方式。
时间轴中的点由汇总时间段的起始 UTC 定义。该时长在 AggregationPeriod 中隐含。
如果指标集支持每小时汇总时段,则始终以世界协调时间 (UTC) 指定,以免因夏令时转换而产生歧义:采用夏令时时,系统会跳过 1 小时;放弃夏令时时重复一个小时。例如,时间戳“2021-11-07 01:00:00 美国/洛杉矶”不明确,因为它可能对应“2021-11-07 08:00:00 世界协调时间 (UTC)”或“2021-11-07 09:00:00 世界协调时间 (UTC)”。
每日汇总期间需要指定一个时区,该时区将确定开始和结束时段的确切时刻。并非所有指标集都支持所有时区,因此请务必检查您要查询的指标集支持哪些时区。
JSON 表示法 |
---|
{ "aggregationPeriod": enum ( |
字段 | |
---|---|
aggregationPeriod |
时间轴中数据点的汇总时间段类型。 间隔根据间隔开始的日期和时间进行标识。 |
startTime |
时间轴的起始数据点(含边界值)。必须与汇总期一致,如下所示:
终点的时区必须与起点的时区一致。 |
endTime |
时间轴的结束数据点(不含此值)。如需了解限制,请参阅 startTime。终点的时区必须与起点的时区一致。 |
DimensionValue
表示单个维度的值。
JSON 表示法 |
---|
{ "dimension": string, "valueLabel": string, // Union field |
字段 | |
---|---|
dimension |
维度的名称。 |
valueLabel |
(可选)简单易懂的值标签,一律用英文表示。例如,对于西班牙国家/地区代码,应使用“西班牙”。 维度值虽然稳定,但此值标签可能会发生变化。不要假设 (value, valueLabel) 关系是稳定的。例如,ISO 国家/地区代码“MK”最近已改名为“北马其顿”。 |
联合字段 value 。维度的实际值。取决于类型。value 只能是下列其中一项: |
|
stringValue |
实际值,以字符串表示。 |
int64Value |
实际值,以 int64 表示。 |
MetricValue
表示指标的值。
JSON 表示法 |
---|
{ "metric": string, // Union field |
字段 | |
---|---|
metric |
指标的名称。 |
联合字段 value 。指标的实际值。取决于类型。value 只能是下列其中一项: |
|
decimalValue |
实际值,以十进制数字表示。 |
联合字段 confidence_interval 。如果指定,表示值的置信区间。confidence_interval 只能是下列其中一项: |
|
decimalValueConfidenceInterval |
|
小数置信度
表示指标的置信区间。
JSON 表示法 |
---|
{ "lowerBound": { object ( |
字段 | |
---|---|
lowerBound |
置信区间的下限。 |
upperBound |
置信区间的上限。 |
方法 |
|
---|---|
|
列出任何数据集中的异常。 |