REST Resource: anomalies

资源：异常

表示在数据集中检测到的异常。

我们的异常检测系统会标记时间序列中超出根据历史数据得出的预期范围的数据点。虽然这些预期范围有上限和下限，但我们仅在数据意外变差时标记异常，这通常对应于指标超出上限的情况。

时间轴中超出预期范围的多个连续数据点将归为单个异常。因此，异常实际上表示指标时间轴的某个片段。存储在 timelineSpec、dimensions 和 metric 中的信息可用于提取具有扩展范围的完整时间轴，以了解上下文。

必需的权限：如需访问此资源，调用用户需要拥有应用的查看应用信息（只读）权限。

JSON 表示法 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
字段
name

string

标识符。异常的名称。

格式：apps/{app}/anomalies/{anomaly}
metricSet

string

检测到异常的指标集资源。
timelineSpec

object (TimelineSpec)

涵盖异常时间段的时间轴规范。
dimensions[]

object (DimensionValue)

检测到异常的维度组合。
metric

object (MetricValue)

检测到异常的指标以及异常值。

TimelineSpec

时间轴的时间相关聚合参数的规范。

时间轴具有聚合周期（DAILY、HOURLY 等），用于定义如何在指标中聚合事件。

时间轴中的点由聚合周期的开始日期时间定义。时长隐含在 AggregationPeriod 中。

如果指标集支持，则始终以世界协调时间 (UTC) 指定每小时汇总周期，以避免夏令时转换期间出现歧义，因为采用夏令时时会跳过一小时，放弃夏令时时会重复一小时。例如，时间戳“2021-11-07 01:00:00 America/Los_Angeles”存在歧义，因为它可能对应于“2021-11-07 08:00:00 UTC”或“2021-11-07 09:00:00 UTC”。

每日聚合周期需要指定时区，该时区将确定一天的开始和结束的确切时间。并非所有指标集都支持所有时区，因此请务必检查您要查询的指标集支持哪些时区。

JSON 表示法 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
字段
aggregationPeriod

enum (AggregationPeriod)

可选。时间轴中数据点的聚合周期的类型。

间隔由间隔开始时的日期和时间标识。
startTime

object (DateTime)

可选。时间轴的起始数据点（含）。必须与聚合周期对齐，如下所示：

  • HO网址Y：必须取消设置“minutes”“seconds”和“nanos”字段。可以取消设置 timeZone（默认为 UTC），也可以将其明确设置为“UTC”。设置任何其他 utcOffset 或时区 ID 都会导致验证错误。
  • DAILY：必须取消设置“hours”“minutes”“seconds”和“nanos”字段。不同的指标集支持不同的时区。可以取消设置，以使用指标集指定的默认时区。

终点时区必须与起点时区一致。
endTime

object (DateTime)

可选。时间轴的结束数据点（不含）。如需了解限制，请参阅 startTime。终点时区必须与起点时区一致。

DimensionValue

表示单个维度的值。

JSON 表示法 
{
  "dimension": string,
  "valueLabel": string,

  // Union field value can be only one of the following:
  "stringValue": string,
  "int64Value": string
  // End of list of possible types for union field value.
}
字段
dimension

string

维度的名称。
valueLabel

string

可选。值的易记标签，始终采用英文。例如，国家/地区代码“ES”对应的标签为“Spain”。

维度值是稳定的，但此值标签可能会发生变化。请勿假定 (value, valueLabel) 关系是稳定的。例如，ISO 国家/地区代码“MK”最近更名为“North Macedonia”。
联合字段 value。维度的实际值。取决于类型。value 只能是下列其中一项：
stringValue

string

实际值，以字符串表示。
int64Value

string (int64 format)

实际值，以 int64 表示。

MetricValue

表示指标的值。

JSON 表示法 
{
  "metric": string,

  // Union field value can be only one of the following:
  "decimalValue": {
    object (Decimal)
  }
  // End of list of possible types for union field value.

  // Union field confidence_interval can be only one of the following:
  "decimalValueConfidenceInterval": {
    object (DecimalConfidenceInterval)
  }
  // End of list of possible types for union field confidence_interval.
}
字段
metric

string

指标的名称。
联合字段 value。指标的实际值。取决于类型。value 只能是下列其中一项：
decimalValue

object (Decimal)

实际值，以十进制数表示。
联合字段 confidence_interval。如果给定，则表示值的置信区间。confidence_interval 只能是下列其中一项：
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

类型为 type.Decimal 的值的置信区间。

DecimalConfidenceInterval

表示指标的置信区间。

JSON 表示法 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
字段
lowerBound

object (Decimal)

置信区间的下限。
upperBound

object (Decimal)

置信区间的上限。

方法

list

 列出任何数据集中的异常。