REST Resource: anomalies

Tài nguyên: Điểm bất thường

Biểu thị một điểm bất thường được phát hiện trong một tập dữ liệu.

Hệ thống phát hiện điểm bất thường của chúng tôi sẽ gắn cờ những điểm dữ liệu nằm ngoài phạm vi dự kiến trong một chuỗi thời gian, dựa trên dữ liệu trong quá khứ. Mặc dù những phạm vi dự kiến đó có giới hạn trên và giới hạn dưới, nhưng chúng tôi chỉ gắn cờ điểm bất thường khi dữ liệu trở nên xấu đi một cách bất ngờ. Điều này thường xảy ra khi chỉ số vượt quá giới hạn trên.

Nhiều điểm dữ liệu liên tiếp trong một dòng thời gian nằm ngoài phạm vi dự kiến sẽ được nhóm thành một điểm bất thường. Do đó, điểm bất thường thực sự là một đoạn trong dòng thời gian của một chỉ số. Thông tin được lưu trữ trong timelineSpec, dimensions và metric có thể được dùng để tìm nạp một dòng thời gian đầy đủ với phạm vi mở rộng cho ngữ cảnh.

Quyền bắt buộc: để truy cập vào tài nguyên này, người dùng gọi cần có quyền Xem thông tin ứng dụng (chỉ có thể đọc) cho ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Trường
name

string

Giá trị nhận dạng. Tên của điểm bất thường.

Định dạng: apps/{app}/anomalies/{anomaly}
metricSet

string

Tài nguyên tập hợp chỉ số nơi phát hiện điểm bất thường.
timelineSpec

object (TimelineSpec)

Quy cách dòng thời gian bao gồm khoảng thời gian xảy ra điểm bất thường.
dimensions[]

object (DimensionValue)

Tổ hợp phương diện mà bạn phát hiện thấy điểm bất thường.
metric

object (MetricValue)

Chỉ số phát hiện điểm bất thường, cùng với giá trị bất thường.

TimelineSpec

Quy cách của các tham số tổng hợp liên quan đến thời gian của một dòng thời gian.

Dòng thời gian có một khoảng thời gian tổng hợp (DAILY, HOURLY, v.v.) xác định cách các sự kiện được tổng hợp trong các chỉ số.

Các điểm trong dòng thời gian được xác định bằng DateTime bắt đầu của khoảng thời gian tổng hợp. Thời lượng được ngầm định trong AggregationPeriod.

Khoảng thời gian tổng hợp theo giờ (nếu được một bộ chỉ số hỗ trợ) luôn được chỉ định theo giờ UTC để tránh sự mơ hồ về việc chuyển đổi sang giờ mùa hè, trong đó một giờ bị bỏ qua khi áp dụng giờ mùa hè và lặp lại khi không áp dụng giờ mùa hè. Ví dụ: dấu thời gian "2021-11-07 01:00:00 America/Los_Angeles" là không rõ ràng vì có thể tương ứng với "2021-11-07 08:00:00 UTC" hoặc "2021-11-07 09:00:00 UTC".

Các khoảng thời gian tổng hợp hằng ngày yêu cầu bạn chỉ định một múi giờ để xác định thời điểm chính xác bắt đầu và kết thúc ngày. Không phải tất cả các bộ chỉ số đều hỗ trợ tất cả các múi giờ, vì vậy, hãy nhớ kiểm tra xem bộ chỉ số mà bạn muốn truy vấn có hỗ trợ múi giờ nào hay không.

Biểu diễn dưới dạng JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Trường
aggregationPeriod

enum (AggregationPeriod)

Loại khoảng thời gian tổng hợp của các điểm dữ liệu trong dòng thời gian.

Khoảng thời gian được xác định bằng ngày và giờ bắt đầu của khoảng thời gian đó.
startTime

object (DateTime)

Điểm dữ liệu bắt đầu của dòng thời gian (bao gồm cả điểm này). Phải được điều chỉnh theo khoảng thời gian tổng hợp như sau:

  • HOURLY: bạn phải đặt các trường "minutes", "seconds" và "nanos" thành chưa đặt. Bạn có thể không đặt timeZone (mặc định là UTC) hoặc đặt rõ ràng thành "UTC". Việc đặt bất kỳ utcOffset hoặc mã nhận dạng múi giờ nào khác sẽ dẫn đến lỗi xác thực.
  • HÀNG NGÀY: bạn phải huỷ đặt các trường "giờ", "phút", "giây" và "nano giây". Các nhóm chỉ số khác nhau hỗ trợ các múi giờ khác nhau. Bạn có thể không đặt giá trị này để sử dụng múi giờ mặc định do bộ chỉ số chỉ định.

Múi giờ của điểm cuối phải khớp với múi giờ của điểm bắt đầu.
endTime

object (DateTime)

Điểm dữ liệu kết thúc của dòng thời gian (không bao gồm). Xem startTime để biết các quy định hạn chế. Múi giờ của điểm cuối phải khớp với múi giờ của điểm bắt đầu.

DimensionValue

Biểu thị giá trị của một phương diện duy nhất.

Biểu diễn dưới dạng 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.
}
Trường
dimension

string

Tên của phương diện.
valueLabel

string

Không bắt buộc. Nhãn thân thiện với người dùng cho giá trị, luôn bằng tiếng Anh. Ví dụ: "Tây Ban Nha" cho mã quốc gia "ES".

Trong khi giá trị phương diện ổn định, nhãn giá trị này có thể thay đổi. Đừng cho rằng mối quan hệ (value, valueLabel) là ổn định. Ví dụ: mã quốc gia theo ISO "MK" gần đây đã đổi tên thành "Bắc Macedonia".
Trường nhóm value. Giá trị thực tế của phương diện. Phụ thuộc vào loại. value chỉ có thể là một trong những trạng thái sau:
stringValue

string

Giá trị thực tế, được biểu thị dưới dạng một chuỗi.
int64Value

string (int64 format)

Giá trị thực, được biểu thị dưới dạng int64.

MetricValue

Biểu thị giá trị của một chỉ số.

Biểu diễn dưới dạng 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.
}
Trường
metric

string

Tên của chỉ số.
Trường nhóm value. Giá trị thực tế của chỉ số. Phụ thuộc vào loại. value chỉ có thể là một trong những trạng thái sau:
decimalValue

object (Decimal)

Giá trị thực tế, được biểu thị dưới dạng số thập phân.
Trường nhóm confidence_interval. Nếu được cung cấp, thì đây là khoảng tin cậy cho giá trị. confidence_interval chỉ có thể là một trong những trạng thái sau:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Khoảng tin cậy của một giá trị thuộc loại type.Decimal.

DecimalConfidenceInterval

Biểu thị khoảng tin cậy của một chỉ số.

Biểu diễn dưới dạng JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Trường
lowerBound

object (Decimal)

Giới hạn dưới của khoảng tin cậy.
upperBound

object (Decimal)

Giới hạn trên của khoảng tin cậy.

Phương thức

list

 Liệt kê các điểm bất thường trong bất kỳ tập dữ liệu nào.