REST Resource: anomalies

Zasób: anomalia

Reprezentuje anomalię wykrytą w zbiorze danych.

Nasze systemy wykrywania anomalii oznaczają punkty danych w ciągach czasowych, które wykraczają poza oczekiwany zakres i pochodzą z danych historycznych. Chociaż oczekiwane zakresy mają górną i dolną granicę, oznaczamy anomalie tylko wtedy, gdy dane są nieoczekiwanie gorsze, co zwykle ma miejsce w przypadkach, gdy dane przekraczają górną granicę.

Wiele sąsiednich punktów danych znajdujących się na osi czasu poza oczekiwanym zakresem zostanie zgrupowanych w jednej anomalii. W efekcie anomalia efektywnie przedstawia dany segment danych na osi czasu. Informacje zapisane w tagach timelineSpec, dimensions i metric mogą służyć do pobierania pełnej osi czasu z rozszerzonym zasięgiem.

Wymagane uprawnienia: aby uzyskać dostęp do tego zasobu, użytkownik wywołujący musi mieć uprawnienie Wyświetlanie informacji o aplikacji (tylko do odczytu) dla aplikacji.

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

string

Nazwa anomalii.

Format: aplikacje/{aplikacja}/anomalie/{anomaly}
metricSet

string

Zasób zestawu wskaźników, w którym wykryto anomalię.
timelineSpec

object (TimelineSpec)

Specyfikacja osi czasu, która obejmuje okres anomalii.
dimensions[]

object (DimensionValue)

Połączenie wymiarów, w którym wykryto anomalię.
metric

object (MetricValue)

Wskaźnik, w którym wykryto anomalię, razem z anomalią.

Specyfikacja osi czasu

Specyfikacja parametrów agregacji związanych z czasem.

Na osi czasu znajduje się okres agregacji (DAILY, HOURLY itd.), który określa sposób agregowania zdarzeń w danych.

Punkty na osi czasu są określane przez datę rozpoczęcia godziny agregacji. Czas trwania jest zdefiniowany w polu AggregationPeriod.

Okresy agregacji godzinowych, jeśli są obsługiwane przez zestaw danych, są zawsze podawane w czasie UTC, aby uniknąć niejasności w przypadku zmian czasu letniego, po których godzina jest pomijana w przypadku zastosowania czasu letniego, i powtarzana, gdy użytkownik opuszcza czas letni. Sygnatura czasowa „2021-11-07 01:00:00 Europe/Los_Angeles” jest niejednoznaczna, ponieważ może odpowiadać nazwie „2021-11-07 08:00:00 UTC” lub „2021-11-07 09:00:00 UTC”.

Dzienne okresy agregacji wymagają określenia strefy czasowej, która decyduje o dokładnych momentach rozpoczęcia i zakończenia dnia. Nie wszystkie zestawy danych obsługują wszystkie strefy czasowe, więc sprawdź, które strefy czasowe są obsługiwane przez ten zestaw danych, do którego chcesz przesłać zapytanie.

Zapis JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Pola
aggregationPeriod

enum (AggregationPeriod)

Typ okresu agregacji punktów danych na osi czasu.

Interwały są określane na podstawie daty i godziny na początku przedziału czasu.
startTime

object (DateTime)

początkowy punkt danych osi czasu (włącznie). Musi pasować do okresu agregacji:

  • HOUR: pola „minutes”, „seconds” i „nanos” muszą być wyłączone. TimeZone może pozostać nieskonfigurowana (wartość domyślna to UTC) lub może być ustawiona na „UTC”. Ustawienie innych identyfikatorów utcOffset lub strefy czasowej spowoduje błąd weryfikacji.
  • DZIENNIE: pola „godziny”, „minuty”, „sekundy” i „nanos” muszą zostać usunięte. Różne zestawy danych obsługują różne strefy czasowe. Aby używać domyślnej strefy czasowej określonej w zbiorze danych, nie musisz jej ustawiać.

Strefa czasowa punktu końcowego musi odpowiadać strefie czasowej punktu początkowego.
endTime

object (DateTime)

Końcowy punkt danych osi czasu (wyłącznie). Informacje o ograniczeniach znajdziesz w punkcie startTime. Strefa czasowa punktu końcowego musi odpowiadać strefie czasowej punktu początkowego.

Wartość wymiaru

Odzwierciedla wartość pojedynczego wymiaru.

Zapis 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.
}
Pola
dimension

string

Nazwa wymiaru.
valueLabel

string

Opcjonalnie. Przyjazna dla ludzi etykieta wartości dla zawsze wartości w języku angielskim. np. „Hiszpania” jako kod kraju „ES”.

Chociaż wartość wymiaru jest stabilna, ta etykieta wartości może ulec zmianie. Nie zakładaj, że relacja (wartość, wartośćEtykiety) jest stabilna. Na przykład kod kraju ISO „MK” zmienił ostatnio swoją nazwę na „Macedonia Północna”.
Pole sumy: value. Rzeczywista wartość wymiaru. Zależne od typu. value może mieć tylko jedną z tych wartości:
stringValue

string

Rzeczywista wartość, podana w postaci ciągu znaków.
int64Value

string (int64 format)

Rzeczywista wartość, wyrażona jako int64.

Wartość danych

Odzwierciedla wartość danych.

Zapis 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.
}
Pola
metric

string

Nazwa wskaźnika.
Pole sumy: value. Rzeczywista wartość danych. Zależne od typu. value może mieć tylko jedną z tych wartości:
decimalValue

object (Decimal)

Rzeczywista wartość wyrażona jako liczba dziesiętna.
Pole sumy: confidence_interval. Podana wartość pokazuje przedział ufności dla wartości. confidence_interval może mieć tylko jedną z tych wartości:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Przedział ufności wartości typu type.Decimal.

Przedział dziesiętny ufności

Reprezentuje przedział ufności wskaźnika.

Zapis JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Pola
lowerBound

object (Decimal)

Dolna granica przedziału ufności.
upperBound

object (Decimal)

Górna granica przedziału ufności.

Metody

list

 Wyświetla anomalie w dowolnym zbiorze danych.