REST Resource: anomalies

Resource: Anomaly

Mewakili anomali yang terdeteksi dalam set data.

Sistem deteksi anomali kami menandai titik data dalam deret waktu yang berada di luar rentang yang diharapkan yang berasal dari data historis. Meskipun rentang yang diharapkan tersebut memiliki batas atas dan bawah, kami hanya menandai anomali jika data menjadi lebih buruk secara tidak terduga, yang biasanya sesuai dengan kasus saat metrik melampaui batas atas.

Beberapa titik data berdekatan dalam linimasa di luar rentang yang diharapkan akan dikelompokkan menjadi satu anomali. Oleh karena itu, anomali secara efektif merepresentasikan segmen linimasa metrik. Informasi yang disimpan di timelineSpec, dimensions, dan metric dapat digunakan untuk mengambil linimasa lengkap dengan rentang yang diperluas untuk konteks.

Izin yang diperlukan: untuk mengakses resource ini, pengguna yang memanggil memerlukan izin Melihat informasi aplikasi (hanya baca) untuk aplikasi.

Representasi JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Kolom
name

string

ID. Nama anomali.

Format: apps/{app}/anomalies/{anomaly}
metricSet

string

Resource set metrik tempat anomali terdeteksi.
timelineSpec

object (TimelineSpec)

Spesifikasi linimasa yang mencakup periode anomali.
dimensions[]

object (DimensionValue)

Kombinasi dimensi tempat anomali terdeteksi.
metric

object (MetricValue)

Metrik tempat anomali terdeteksi, beserta nilai anomali.

TimelineSpec

Spesifikasi parameter agregasi terkait waktu dari linimasa.

Linimasa memiliki periode agregasi (DAILY, HOURLY, dll.) yang menentukan cara peristiwa diagregasi dalam metrik.

Titik-titik dalam linimasa ditentukan oleh DateTime awal periode agregasi. Durasi tersirat dalam AggregationPeriod.

Periode agregasi per jam, jika didukung oleh set metrik, selalu ditentukan dalam UTC untuk menghindari ambiguitas seputar transisi waktu musim panas, di mana satu jam dilewati saat mengadopsi DST, dan diulang saat menghentikan DST. Misalnya, stempel waktu '2021-11-07 01:00:00 America/Los_Angeles' ambigu karena dapat sesuai dengan '2021-11-07 08:00:00 UTC' atau '2021-11-07 09:00:00 UTC'.

Periode agregasi harian memerlukan penentuan zona waktu yang akan menentukan waktu mulai dan akhir hari yang tepat. Tidak semua set metrik mendukung semua zona waktu, jadi pastikan untuk memeriksa zona waktu mana yang didukung oleh set metrik yang ingin Anda kueri.

Representasi JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Kolom
aggregationPeriod

enum (AggregationPeriod)

Jenis periode agregasi titik data dalam linimasa.

Interval diidentifikasi berdasarkan tanggal dan waktu di awal interval.
startTime

object (DateTime)

Titik data awal linimasa (inklusif). Harus diselaraskan dengan periode penggabungan sebagai berikut:

  • PER JAM: kolom 'minutes', 'seconds', dan 'nanos' harus tidak disetel. timeZone dapat dibiarkan tidak ditetapkan (defaultnya adalah UTC) atau ditetapkan secara eksplisit ke "UTC". Menetapkan utcOffset atau ID zona waktu lainnya akan menghasilkan error validasi.
  • HARIAN: kolom 'hours', 'minutes', 'seconds', dan 'nanos' harus tidak disetel. Kumpulan metrik yang berbeda mendukung zona waktu yang berbeda. Parameter ini dapat dibiarkan tidak disetel untuk menggunakan zona waktu default yang ditentukan oleh set metrik.

Zona waktu titik akhir harus cocok dengan zona waktu titik awal.
endTime

object (DateTime)

Titik data akhir linimasa (eksklusif). Lihat startTime untuk mengetahui batasan. Zona waktu titik akhir harus cocok dengan zona waktu titik awal.

DimensionValue

Mewakili nilai satu dimensi.

Representasi 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.
}
Kolom
dimension

string

Nama dimensi.
valueLabel

string

Opsional. Label yang mudah dibaca untuk nilai, selalu dalam bahasa Inggris. Misalnya, 'Spanyol' untuk kode negara 'ES'.

Meskipun nilai dimensi stabil, label nilai ini dapat berubah. Jangan mengasumsikan bahwa hubungan (nilai, valueLabel) stabil. Misalnya, kode negara ISO 'MK' baru-baru ini mengubah namanya menjadi 'Makedonia Utara'.
Kolom union value. Nilai sebenarnya dari dimensi. Bergantung pada jenis. value hanya dapat berupa salah satu dari berikut:
stringValue

string

Nilai sebenarnya, direpresentasikan sebagai string.
int64Value

string (int64 format)

Nilai sebenarnya, ditampilkan sebagai int64.

MetricValue

Mewakili nilai metrik.

Representasi 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.
}
Kolom
metric

string

Nama metrik.
Kolom union value. Nilai sebenarnya metrik. Bergantung pada jenis. value hanya dapat berupa salah satu dari berikut:
decimalValue

object (Decimal)

Nilai sebenarnya, yang ditampilkan sebagai angka desimal.
Kolom union confidence_interval. Jika diberikan, mewakili interval keyakinan untuk nilai. confidence_interval hanya dapat berupa salah satu dari berikut:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Interval keyakinan dari nilai yang berjenis type.Decimal.

DecimalConfidenceInterval

Mewakili interval keyakinan metrik.

Representasi JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Kolom
lowerBound

object (Decimal)

Batas bawah interval keyakinan.
upperBound

object (Decimal)

Batas atas interval keyakinan.

Metode

list

 Mencantumkan anomali di salah satu set data.