REST Resource: anomalies

Risorsa: anomalie

Rappresenta un'anomalia rilevata in un set di dati.

I nostri sistemi di rilevamento di anomalie segnalano punti dati in una serie temporale che non rientrano nell'intervallo previsto e derivano dai dati storici. Sebbene questi intervalli previsti abbiano un limite superiore e un limite inferiore, segnaliamo le anomalie solo quando i dati sono diventati peggiori, il che corrisponde di solito al caso in cui la metrica supera il limite superiore.

Più punti dati contigui in una sequenza temporale che non rientrano nell'intervallo previsto verranno raggruppati in una singola anomalia. Di conseguenza, un'anomalia rappresenta in modo efficace un segmento della sequenza temporale di una metrica. Le informazioni archiviate in timelineSpec, dimensions e metric possono essere utilizzate per recuperare una cronologia completa con contesto esteso.

Autorizzazioni richieste: per accedere a questa risorsa, l'utente chiamante ha bisogno dell'autorizzazione Visualizzazione di informazioni sull'app (sola lettura) per l'app.

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

string

Nome dell'anomalia.

Formato: apps/{app}/anomalies/{anomaly}

metricSet

string

Risorsa del set di metriche in cui è stata rilevata l'anomalia.

timelineSpec

object (TimelineSpec)

Specifica della sequenza temporale che riguarda il periodo dell'anomalia.

dimensions[]

object (DimensionValue)

Combinazione di dimensioni in cui è stata rilevata l'anomalia.

metric

object (MetricValue)

Metrica in cui è stata rilevata l'anomalia, insieme al valore anomalo.

Sequenza temporale

Specifica dei parametri di aggregazione correlati al tempo di una sequenza temporale.

Le tempistiche hanno un periodo di aggregazione (DAILY, HOURLY e così via) che definisce la modalità di aggregazione degli eventi nelle metriche.

I punti di una sequenza temporale sono definiti dalla data iniziale del periodo di aggregazione. La durata è implicita nell'AggregationPeriod.

I periodi di aggregazione orari, se supportati da una serie di metriche, sono sempre specificati in UTC per evitare ambiguità relative alle transizioni all'ora legale, in cui un'ora viene saltata quando si adotta l'ora legale e viene ripetuta quando si abbandona l'ora legale. Ad esempio, il timestamp "2021-11-07 01:00:00 America/Los_Angeles" è ambiguo perché può corrispondere a "2021-11-07 08:00:00 UTC" o "2021-11-07 09:00:00 UTC".

Per i periodi di aggregazione giornalieri è necessario specificare un fuso orario che determinerà gli istanti precisi di inizio e di fine della giornata. Non tutti gli insiemi di metriche supportano tutti i fusi orari, quindi assicurati di verificare quali fusi sono supportati dall'insieme di metriche in cui vuoi eseguire la query.

Rappresentazione JSON
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Campi
aggregationPeriod

enum (AggregationPeriod)

Tipo di periodo di aggregazione dei punti dati nella sequenza temporale.

Gli intervalli sono identificati dalla data e dall'ora all'inizio dell'intervallo.

startTime

object (DateTime)

Punto di dati iniziale della sequenza temporale (inclusivo). Deve essere in linea con il periodo di aggregazione come segue:

  • ORA: i campi "minuti", "secondi" e "nano" non devono essere impostati. Il fuso orario può essere lasciato non impostato (il valore predefinito è UTC) o esplicitamente su "UTC". L'impostazione di qualsiasi altro ID fuso orario o utcOffset comporterà un errore di convalida.
  • GIORNALIERO: i campi "ore", "minuti", "secondi" e "nano" non devono essere impostati. Set di metriche differenti supportano fusi orari diversi. Non può essere impostato per utilizzare il fuso orario predefinito specificato dalla metrica.

Il fuso orario del punto di arrivo deve corrispondere al fuso orario del punto di partenza.

endTime

object (DateTime)

Punto dati finale della sequenza temporale (esclusivo). Vedi startTime per le limitazioni. Il fuso orario del punto di arrivo deve corrispondere al fuso orario del punto di partenza.

DimensionValue

Rappresenta il valore di una singola dimensione.

Rappresentazione 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.
}
Campi
dimension

string

Nome della dimensione.

valueLabel

string

Campo facoltativo. Etichetta facile da ricordare per il valore, sempre in inglese. Ad esempio, "Spagna" per il codice paese "ES".

Mentre il valore della dimensione è stabile, questa etichetta è soggetta a modifiche. Non dare per scontato che la relazione (value, valueLabel) sia stabile. Ad esempio, di recente il codice paese ISO "MK" ha cambiato il suo nome in "Macedonia del Nord".

Campo di unione value. Valore effettivo della dimensione. Dipende dal tipo. value può essere solo uno dei seguenti:
stringValue

string

Il valore effettivo, rappresentato da una stringa.

int64Value

string (int64 format)

Il valore effettivo, indicato come int64.

MetricValue

Rappresenta il valore di una metrica.

Rappresentazione 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.
}
Campi
metric

string

Il nome della metrica.

Campo di unione value. Valore effettivo della metrica. Dipende dal tipo. value può essere solo uno dei seguenti:
decimalValue

object (Decimal)

Il valore effettivo, rappresentato da un numero decimale.

Campo di unione confidence_interval. Se specificato, rappresenta un intervallo di confidenza per il valore. confidence_interval può essere solo uno dei seguenti:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Intervallo di confidenza di un valore di tipo type.Decimal.

Intervallo di confidenza decimale

Rappresenta l'intervallo di confidenza di una metrica.

Rappresentazione JSON
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Campi
lowerBound

object (Decimal)

Limite inferiore dell'intervallo di confidenza.

upperBound

object (Decimal)

Il limite superiore dell'intervallo di confidenza.

Metodi

list

Elenca le anomalie in qualsiasi set di dati.