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)

偵測到異常狀況的指標，以及異常值。

時間軸規格

時間軸的相關時間匯總參數規格。

時間軸會提供匯總期間 (DAILY、HOURLY 等)，以定義事件在指標中的匯總方式。

時間軸上的點是由匯總週期的開始日期起算。AggregationPeriod 具有隱含性質。

使用指標組合支援的每小時匯總期間，一律一律以世界標準時間為準，避免發生日光節約時間發生混淆的情況。採用 DST 時，系統會略過一小時，並在 DST 放棄時重複。例如，時間戳記「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)

時間軸的資料點 (含首尾)。必須與匯總週期一致，如下所示：

  • HOURLY：必須設定「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」代表「ES」國家/地區代碼。

維度值保持穩定，但這個值標籤可能會有變動。請勿假設 (value, valueLabel) 關係保持穩定。例如，ISO 國家/地區代碼「MK」最近更名為「北馬其頓」。
聯集欄位 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 類型的信賴區間。

十進位信賴區間間隔

代表指標的信賴區間。

JSON 表示法 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
欄位
lowerBound

object (Decimal)

信賴區間的下限值。
upperBound

object (Decimal)

信賴區間上限。

方法

list

 列出任何資料集內的異常狀況。