REST Resource: anomalies

Zasób: Anomaly

Reprezentuje anomalię wykrytą w zbiorze danych.

Nasze systemy wykrywania anomalii oznaczają w ciągu czasowym punkty danych, które wykraczają poza oczekiwany zakres wyznaczony na podstawie danych historycznych. Chociaż oczekiwane zakresy mają górną i dolną granicę, anomalie oznaczamy tylko wtedy, gdy dane niespodziewanie się pogorszą, co zwykle ma miejsce, gdy wartość danych przekroczy górną granicę.

Wiele sąsiadujących ze sobą punktów danych na osi czasu, które wykraczają poza oczekiwany zakres, zostanie zgrupowanych w jedną anomalię. Anomalia to zatem segment osi czasu danego rodzaju danych. Informacje przechowywane w timelineSpec, dimensions i metric mogą być używane do pobierania pełnej osi czasu z rozszerzonym zakresem w celu uzyskania kontekstu.

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) w przypadku aplikacji.

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

string

Identyfikator. Nazwa anomalii.

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

string

Zasób zestawu danych, w którym wykryto anomalię.
timelineSpec

object (TimelineSpec)

Specyfikacja osi czasu obejmująca okres anomalii.
dimensions[]

object (DimensionValue)

Kombinacja wymiarów, w której wykryto anomalię.
metric

object (MetricValue)

Rodzaj danych, w których wykryto anomalię, wraz z wartością anomalii.

TimelineSpec

Specyfikacja parametrów agregacji osi czasu związanych z czasem.

Osie czasu mają okres agregacji (DAILY, HOURLY itp.), który określa sposób agregowania zdarzeń w danych.

Punkty na osi czasu są definiowane przez datę i godzinę rozpoczęcia okresu agregacji. Czas trwania jest domyślnie określony w parametrze AggregationPeriod.

Godzinowe okresy agregacji, jeśli są obsługiwane przez zestaw danych, są zawsze podawane w czasie UTC, aby uniknąć niejednoznaczności związanych ze zmianą czasu na letni, gdy godzina jest pomijana podczas przechodzenia na czas letni i powtarzana podczas powrotu do czasu zimowego. Na przykład sygnatura czasowa „2021-11-07 01:00:00 America/Los_Angeles” jest niejednoznaczna, ponieważ może odpowiadać sygnaturze „2021-11-07 08:00:00 UTC” lub „2021-11-07 09:00:00 UTC”.

Okresy agregacji dziennej wymagają określenia strefy czasowej, która będzie wyznaczać dokładne momenty 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 zestaw danych, o który chcesz wysł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.

Przedziały są identyfikowane na podstawie daty i godziny rozpoczęcia.
startTime

object (DateTime)

Początkowy punkt danych na osi czasu (włącznie). Musi być zgodny z okresem agregacji w ten sposób:

  • HOURLY: pola „minutes”, „seconds” i „nanos” muszą być nieustawione. Parametr timeZone można pozostawić bez ustawienia (domyślnie jest to UTC) lub ustawić go jawnie na „UTC”. Ustawienie innego identyfikatora utcOffset lub strefy czasowej spowoduje błąd weryfikacji.
  • DAILY: pola „hours”, „minutes”, „seconds” i „nanos” muszą być puste. Różne zestawy danych obsługują różne strefy czasowe. Można pozostawić to pole bez ustawienia, aby używać domyślnej strefy czasowej określonej przez zestaw danych.

Strefa czasowa punktu końcowego musi być zgodna ze strefą czasową punktu początkowego.
endTime

object (DateTime)

Końcowy punkt danych na osi czasu (wyłącznie). Ograniczenia znajdziesz w sekcji startTime. Strefa czasowa punktu końcowego musi być zgodna ze strefą czasową punktu początkowego.

DimensionValue

Reprezentuje 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. Etykieta wartości czytelna dla ludzi, zawsze w języku angielskim. Na przykład „Hiszpania” w przypadku kodu kraju „ES”.

Wartość wymiaru jest stała, ale etykieta tej wartości może ulec zmianie. Nie zakładaj, że relacja (wartość, etykieta wartości) jest stabilna. Na przykład kod kraju ISO „MK” został niedawno zmieniony na „Macedonia Północna”.
Pole unii value. Rzeczywista wartość wymiaru. Zależy od typu. value może mieć tylko jedną z tych wartości:
stringValue

string

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

string (int64 format)

Rzeczywista wartość przedstawiona jako liczba całkowita ze znakiem 64-bitowym.

MetricValue

Reprezentuje 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 rodzaju danych.
Pole unii value. Rzeczywista wartość danych. Zależy od typu. value może mieć tylko jedną z tych wartości:
decimalValue

object (Decimal)

Rzeczywista wartość wyrażona jako liczba dziesiętna.
Pole unii confidence_interval. Jeśli jest podany, reprezentuje 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.

DecimalConfidenceInterval

Przedstawia przedział ufności danych.

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 listę anomalii w dowolnym zbiorze danych.