REST Resource: anomalies

Tài nguyên: Bất thường

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

Hệ thống phát hiện hoạt động bất thường của chúng tôi gắn cờ các điểm dữ liệu trong chuỗi thời gian nằm ngoài phạm vi dự kiến. Dữ liệu này đượ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ờ, thường tương ứng với trường hợp chỉ số vượt quá giới hạn trên.

Nhiều điểm dữ liệu liền kề trong 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 duy nhất. Do đó, một điểm bất thường đại diện cho một phân đoạn trong tiến trình của một chỉ số một cách hiệu quả. Bạn có thể dùng thông tin được lưu trữ trong timelineSpec, dimensions và metric để tìm nạp toàn bộ tiến trình theo ngữ cảnh.

Quyền bắt buộc: để truy cập 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) 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)
  }
}
Các trường
name

string

Tên bất thường.

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

string

Chỉ số đặt tài nguyên phát hiện hoạt động bất thường.
timelineSpec

object (TimelineSpec)

Thông số kỹ thuật về dòng thời gian bao gồm khoảng thời gian bất thường.
dimensions[]

object (DimensionValue)

Tổ hợp các phương diện mà hệ thống phát hiện hoạt động bất thường.
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.

Dòng thời gian

Thông số kỹ thuật của các thông số tổng hợp liên quan đến thời gian của một dòng thời gian.

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

Các điểm trong tiến trình được xác định theo Ngày bắt đầu của giai đoạn tổng hợp. Thời lượng ngầm ẩn trong AggregatPeriod.

Khoảng thời gian tổng hợp hằng giờ khi được một bộ chỉ số hỗ trợ luôn được chỉ định theo giờ UTC để tránh sự mơ hồ trong quá trình chuyển đổi theo giờ mùa hè, trong đó một giờ bị bỏ qua khi sử dụng DST và lặp lại khi bỏ qua DST. Ví dụ: dấu thời gian "2021-11-07 01:00:00 America/Los_Angeles" 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".

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 chính xác thời điểm bắt đầu và kết thúc ngày. Không phải tất cả các múi giờ đều hỗ trợ tất cả múi giờ, vì vậy, hãy nhớ kiểm tra múi giờ mà chỉ số múi giờ 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)
  }
}
Các trường
aggregationPeriod

enum (AggregationPeriod)

Loại 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 theo ngày và giờ bắt đầu khoảng thời gian đó.
startTime

object (DateTime)

Điểm dữ liệu bắt đầu của tiến trình (bao gồm cả tiến trình). Phải được căn chỉnh với khoảng thời gian tổng hợp như sau:

  • ↑ ĐÚNG: các trường "phút", "giây" và "nanos" phải được bỏ đặt. Bạn có thể không đặt múi giờ (mặc định là UTC) hoặc đặt rõ ràng thành "UTC". Việc đặt mã nhận dạng múi giờ hoặc múi giờ khác sẽ dẫn đến lỗi xác thực.
  • DAILY: phải đặt các trường 'hours', 'minutes', 'seconds' và 'nanos'. Các bộ chỉ số khác nhau sẽ hỗ trợ múi giờ khác nhau. Bạn có thể không đặt được múi giờ mặc định do tập chỉ số chỉ định.

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

object (DateTime)

Điểm cuối dữ liệu của dòng thời gian (loại trừ). Hãy xem startTime để biết các hạn chế. Múi giờ của điểm kết thúc phải khớp với múi giờ của điểm bắt đầu.

Giá trị phương diện

Thể hiện giá trị của một phương diện.

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.
}
Các 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 con người 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 giả định rằng mối quan hệ (value, valueLabel) ổn định. Ví dụ: mã quốc gia theo ISO "MK" gần đây đã đổi tên thành "Bắc Macedonia".
Trường liên kết 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 tế, được biểu thị dưới dạng int64.

Giá trị chỉ số

Đạ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.
}
Các trường
metric

string

Tên chỉ số.
Trường liên kết 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 thể hiện dưới dạng số thập phân.
Trường liên kết confidence_interval. Nếu được cung cấp, hãy biểu thị 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.

Khoảng tin cậy thập phân

Thể hiện 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)
  }
}
Các 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.