REST Resource: anomalies

Kaynak: Anormallik

Veri kümesinde algılanan bir anormalliği temsil eder.

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

Bir zaman çizelgesinde beklenen aralığın dışındaki birden fazla bitişik veri noktası tek bir anomali olarak gruplandırılır. Bu nedenle, anomali, bir metriğin zaman çizelgesinin bir bölümünü etkili bir şekilde temsil eder. timelineSpec, dimensions ve metric içinde saklanan bilgiler, bağlam için genişletilmiş aralığa sahip tam bir zaman çizelgesi getirmek üzere kullanılabilir.

Gerekli izinler: Bu kaynağa erişmek için çağıran kullanıcının uygulama için Uygulama bilgilerini görüntüleme (salt okunur) iznine sahip olması gerekir.

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

string

Tanımlayıcı. Anomalinin adı.

Biçim: apps/{app}/anomalies/{anomaly}
metricSet

string

Anormalliğin algılandığı metrik grubu kaynağı.
timelineSpec

object (TimelineSpec)

Anormallik dönemini kapsayan zaman çizelgesi spesifikasyonu.
dimensions[]

object (DimensionValue)

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

object (MetricValue)

Anormalliğin algılandığı metrik ve anormallik değeri.

TimelineSpec

Zaman çizelgesinin zamanla ilgili toplama parametrelerinin belirtilmesi.

Zaman çizelgelerinde, etkinliklerin metriklerde nasıl toplandığını tanımlayan bir toplama dönemi (DAILY, HOURLY vb.) vardır.

Zaman çizelgesindeki noktalar, toplama döneminin başlangıç tarihi ve saatiyle tanımlanır. Süre, AggregationPeriod'da örtülü olarak belirtilir.

Bir metrik kümesi tarafından desteklendiğinde saatlik toplama dönemleri, yaz saati uygulamasına geçişlerle ilgili belirsizlikleri önlemek için her zaman UTC olarak belirtilir. Yaz saati uygulamasına geçildiğinde bir saat atlanır, yaz saati uygulaması bırakıldığında ise bir saat tekrarlanır. Örneğin, "2021-11-07 01:00:00 America/Los_Angeles" zaman damgası, "2021-11-07 08:00:00 UTC" veya "2021-11-07 09:00:00 UTC" ile eşleşebileceğinden belirsizdir.

Günlük toplama dönemlerinde, günün başlangıç ve bitiş anlarını tam olarak belirleyecek bir saat dilimi belirtilmesi gerekir. Tüm metrik kümeleri tüm saat dilimlerini desteklemez. Bu nedenle, sorgulamak istediğiniz metrik kümesinin hangi saat dilimlerini desteklediğini 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şlangıcındaki tarih ve saate göre tanımlanır.
startTime

object (DateTime)

Zaman çizelgesinin başlangıç veri noktası (dahil). Aşağıdaki gibi toplama dönemine göre hizalanmalıdır:

  • SAATLİK: "dakika", "saniye" ve "nanosaniye" alanları ayarlanmamış olmalıdır. timeZone ayarı boş bırakılabilir (varsayılan olarak UTC kullanılır) veya açıkça "UTC" olarak ayarlanabilir. Başka bir utcOffset veya timezone id ayarlanması doğrulama hatasına neden olur.
  • GÜNLÜK: "saat", "dakika", "saniye" ve "nanosaniye" alanları ayarlanmamış olmalıdır. Farklı metrik kümeleri farklı saat dilimlerini destekler. Metrik kümesi tarafından belirtilen varsayılan saat dilimini kullanmak için ayarlanmamış olarak 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ş veri noktası (hariç). Kısıtlamalar için startTime özelliğine bakın. Bitiş noktasının saat dilimi, başlangıç noktasının saat dilimiyle eşleşmelidir.

DimensionValue

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

Boyutun adı.
valueLabel

string

İsteğe bağlıdır. Değer için insan tarafından okunabilir etiket (her zaman İngilizce). Örneğin, "ES" ülke kodu için "İspanya".

Boyut değeri sabit olsa da bu değer etiketi değişebilir. (Değer, değer etiketi) ilişkisinin sabit olduğunu varsaymayın. Örneğin, ISO ülke kodu "MK" kısa süre önce adını "Kuzey Makedonya" olarak değiştirdi.
Birleştirme alanı value. Boyutun gerçek değeri. Türe bağlıdır. value yalnızca aşağıdakilerden biri olabilir:
stringValue

string

Dize olarak gösterilen gerçek değer.
int64Value

string (int64 format)

Gerçek değer, int64 olarak gösterilir.

MetricValue

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ı.
Birleştirme alanı value. Metriğin gerçek değeri. Türe bağlıdır. value yalnızca aşağıdakilerden biri olabilir:
decimalValue

object (Decimal)

Ondalık sayı olarak gösterilen gerçek değer.
Birleştirme alanı confidence_interval. Verildiyse değer için güven aralığını gösterir. confidence_interval yalnızca aşağıdakilerden biri olabilir:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

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

DecimalConfidenceInterval

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.