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 anormallikleri işaretleriz. Bu durum genellikle metriğin üst sınırı aşmasıyla ilişkilidir.

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 belirtimi.
dimensions[]

object (DimensionValue)

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

object (MetricValue)

Anormalliğin algılandığı metrik ve anormal değer.

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ı 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)

İsteğe bağlı. 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)

İsteğe bağlı. Zaman çizelgesinin başlangıç veri noktası (dahil). Aşağıdaki gibi toplama dönemiyle uyumlu olmalı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 kimliği ayarlanırsa doğrulama hatası oluşur.
  • 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)

İsteğe bağlı. 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ı. Değer için her zaman İngilizce olan, kullanıcı dostu etiket. Ö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, "MK" ISO ülke kodu kısa süre önce adını "Kuzey Makedonya" olarak değiştirdi.
value birleşik alanı. Boyutun gerçek değeri. Türe bağlıdır. value aşağıdakilerden yalnızca 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ı.
value birleşik alanı. 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.
confidence_interval birleşik alanı. Verildiyse değer için güven aralığını gösterir. confidence_interval aşağıdakilerden yalnızca 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.