REST Resource: anomalies

Kaynak: Anormallik

Veri kümesinde tespit edilen bir anormalliği temsil eder.

Anormallik algılama sistemlerimiz, geçmiş verilerden türetilen ve beklenen aralığın dışında kalan bir zaman serisindeki veri noktalarını işaretler. Beklenen aralıkların üst ve alt sınırı olsa da anormallikleri yalnızca veriler beklenmedik bir şekilde daha kötü hale geldiğinde işaretleriz. Bu, genellikle metriğin üst sınırı aştığı durumlara karşılık gelir.

Beklenen aralığın dışındaki bir zaman çizelgesindeki birden fazla bitişik veri noktası tek bir anormallikte gruplandırılır. Bu nedenle anormallik, bir metriğin zaman çizelgesini etkili şekilde temsil eder. timelineSpec, dimensions ve metric'da depolanan bilgiler, bağlam için genişletilmiş kanguruyla tam zaman çizelgesini getirmek amacıyla kullanılabilir.

Gerekli izinler: Arayan kullanıcının bu kaynağa erişebilmesi için Uygulama bilgilerini görüntüleme (salt okunur) iznine ihtiyacı vardır.

JSON gösterimi
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Alanlar
name

string

Anormalliğin adı.

Biçim: apps/{uygulama}/anormallikler/{anomali}

metricSet

string

Anormalliğin algılandığı metrik kümesi kaynağı.

timelineSpec

object (TimelineSpec)

Anormallik dönemini kapsayan zaman çizelgesi spesifikasyonu.

dimensions[]

object (DimensionValue)

Anormalliğin algılandığı boyutların kombinasyonu.

metric

object (MetricValue)

Anormal değerin yanı sıra anormalliğin algılandığı metrik.

Zaman ÇizelgesiSpesifikasyonu

Bir zaman çizelgesinin zamanla ilgili toplama parametrelerinin spesifikasyonu.

Zaman çizelgeleri, etkinliklerin metriklerde nasıl toplandığını tanımlayan bir toplama süresine (DAILY, HOURLY vb.) sahiptir.

Zaman çizelgesindeki noktalar, toplama döneminin başlangıç Tarih/Saati ile tanımlanır. Süre, Toplama Süresinde dolaylı.

Bir metrik grubu tarafından desteklendiğinde saatlik toplama süreleri her zaman UTC'de belirtilir. Böylece, YS uygulaması sırasında bir saat atlanır ve YS uygulaması sonlandırılırken bir saat atlanır. Örneğin, "2021-11-07 01:00:00 Amerika/Los_Angeles" zaman damgası belirsizdir, çünkü "2021-11-07 08:00:00 UTC" veya "2021-11-07 09:00:00 UTC"ye karşılık gelebilir.

Günlük toplama dönemleri, günün başlangıcının ve bitişinin tam olarak belirleneceği bir saat dilimi belirtmeyi gerektirir. Tüm metrik grupları tüm saat dilimlerini desteklemez. Bu nedenle, sorgulamak istediğiniz metrik grubu tarafından desteklenen saat dilimlerini kontrol ettiğinizden emin olun.

JSON gösterimi
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Alanlar
aggregationPeriod

enum (AggregationPeriod)

Zaman çizelgesindeki veri noktalarının toplama döneminin türü.

Aralıklar, aralığın başındaki tarih ve saate göre tanımlanır.

startTime

object (DateTime)

Zaman çizelgesinin başlangıç veri noktası (dahil). Toplama dönemi aşağıdaki gibi hizalanmalıdır:

  • HOURLY: "dakika", "saniye" ve "nanos" alanları ayarlanmaz. Saat dilimi ayarlanmadan bırakılabilir (varsayılan olarak UTC'ye ayarlanır) veya açık bir şekilde "UTC" olarak ayarlanabilir. Başka bir utcOffset veya saat dilimi kimliği ayarlandığında doğrulama hatası oluşur.
  • GÜNLÜK: "saat", "dakika", "saniye" ve "nano" alanları ayarlanmaz. Farklı metrik kümeleri farklı saat dilimlerini destekler. Metrik grubu tarafından belirtilen varsayılan saat dilimini kullanmak için ayarlanmadan bırakılabilir.

Bitiş noktasının saat dilimi, başlangıç noktasının saat dilimiyle eşleşmelidir.

endTime

object (DateTime)

Zaman çizelgesinin bitiş noktası (hariç). Kısıtlamalar için başlangıç zamanına bakın. Bitiş noktasının saat dilimi, başlangıç noktasının saat dilimiyle eşleşmelidir.

Boyut Değeri

Tek bir boyutun değerini gösterir.

JSON gösterimi
{
  "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.
}
Alanlar
dimension

string

Boyut adı.

valueLabel

string

İsteğe bağlı. Her zaman İngilizce dilinde, değer için insan dostu etiket. Örneğin, "ES" ülke kodu için "İspanya".

Boyut değeri sabit olsa da bu değer etiketi değişebilir. (value, valueLabel) ilişkisinin kararlı olduğunu varsaymayın. Örneğin, ISO ülke kodu "MK" kısa bir süre önce adını "Kuzey Makedonya" olarak değiştirdi.

Birlik alanı value. Boyutun gerçek değeri. Türe bağlıdır. value aşağıdakilerden yalnızca biri olabilir:
stringValue

string

Dize olarak temsil edilen gerçek değer.

int64Value

string (int64 format)

int64 olarak temsil edilen gerçek değer.

Metrik Değeri

Bir metriğin değerini gösterir.

JSON gösterimi
{
  "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.
}
Alanlar
metric

string

Metriğin adı.

Birlik alanı value. Metriğin gerçek değeri. Türe bağlıdır. value aşağıdakilerden yalnızca biri olabilir:
decimalValue

object (Decimal)

Ondalık sayı olarak gösterilen gerçek değer.

Birlik alanı confidence_interval. Değer sağlanırsa değer için bir güven aralığını temsil eder. confidence_interval aşağıdakilerden yalnızca biri olabilir:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

type.Decimal türündeki bir değerin güven aralığı.

Ondalık Güven Aralığı

Bir metriğin güven aralığını gösterir.

JSON gösterimi
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Alanlar
lowerBound

object (Decimal)

Güven aralığının alt sınırı.

upperBound

object (Decimal)

Güven aralığının üst sınırı.

Yöntemler

list

Veri kümelerindeki anormallikleri listeler.