REST Resource: anomalies

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

Đại diện cho 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 gắn cờ các điểm dữ liệu trong một chuỗi thời gian nằm ngoài phạm vi dự kiến được lấy từ dữ liệu trong quá khứ. Mặc dù các 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ờ các điểm bất thường khi dữ liệu trở nên tệ hơn một cách bất ngờ. Điều này thường tương ứng với trường hợp chỉ số vượt qua giới hạn trên.

Nhiều điểm dữ liệu liền kề 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 đó, một điểm bất thường thực tế đại diện cho một phân khúc của dòng thời gian của một chỉ số. Bạn có thể sử dụng thông tin được lưu trữ trong timelineSpec, dimensions và metric để tìm nạp một dòng thời gian đầy đủ với phạm vi mở rộng cho bối 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

Số 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)

Thông số dòng thời gian bao gồm khoảng thời gian có điểm bất thường.
dimensions[]

object (DimensionValue)

Sự kết hợp của các phương diện mà điểm bất thường được phát hiện.
metric

object (MetricValue)

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

TimelineSpec

Thông số 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 một 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 hiểu trong AggregationPeriod.

Các khoảng thời gian tổng hợp theo giờ, khi được một tập hợp chỉ số hỗ trợ, luôn được chỉ định theo giờ UTC để tránh sự mơ hồ về quá trình chuyển đổi 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 bỏ 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 chỉ định một múi giờ sẽ 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 tập hợp chỉ số đều hỗ trợ tất cả các múi giờ, vì vậy, hãy nhớ kiểm tra những múi giờ được tập hợp chỉ số mà bạn muốn truy vấn hỗ trợ.

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

enum (AggregationPeriod)

Không bắt buộc. 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.

Các khoảng thời gian được xác định bằng ngày và giờ vào đầu khoảng thời gian.
startTime

object (DateTime)

Không bắt buộc. Đ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 căn chỉnh theo khoảng thời gian tổng hợp như sau:

  • HOURLY: các trường "minutes", "seconds" và "nanos" phải được đặt thành không đặt. Bạn có thể để trống 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ã múi giờ nào khác sẽ dẫn đến lỗi xác thực.
  • DAILY: các trường "hours", "minutes", "seconds" và "nanos" phải được đặt thành không đặt. Các tập hợp chỉ số khác nhau hỗ trợ các múi giờ khác nhau. Bạn có thể để trống để sử dụng múi giờ mặc định do tập hợp 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)

Không bắt buộc. Điểm dữ liệu kết thúc của dòng thời gian (không bao gồm điểm này). Xem startTime để biết các 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

Đại diện cho 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ụ: "Spain" 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ệ (giá trị, valueLabel) là ổn định. Ví dụ: mã quốc gia 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 giá trị sau:
stringValue

string

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

string (int64 format)

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

MetricValue

Đại diện cho 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 giá trị sau:
decimalValue

object (Decimal)

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

object (DecimalConfidenceInterval)

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

DecimalConfidenceInterval

Đại diện cho 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.