REST Resource: anomalies

Risorsa: Anomalia

Rappresenta un'anomalia rilevata in un set di dati.

I nostri sistemi di rilevamento delle anomalie contrassegnano i punti dati di una serie temporale che non rientrano in un intervallo previsto derivato dai dati storici. Sebbene questi intervalli previsti abbiano un limite superiore e uno inferiore, segnaliamo le anomalie solo quando i dati sono peggiorati in modo inatteso, il che di solito corrisponde al caso in cui la metrica supera il limite superiore.

Più punti dati contigui in una cronologia al di fuori dell'intervallo previsto verranno raggruppati in un'unica anomalia. Pertanto, un'anomalia rappresenta effettivamente un segmento della cronologia di una metrica. Le informazioni archiviate in timelineSpec, dimensions e metric possono essere utilizzate per recuperare una cronologia completa con un intervallo esteso per il contesto.

Autorizzazioni richieste: per accedere a questa risorsa, l'utente chiamante deve disporre 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

Identificatore. 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 copre 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.

TimelineSpec

Specifica dei parametri di aggregazione correlati al tempo di una cronologia.

Le sequenze temporali 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 e ora di inizio del periodo di aggregazione. La durata è implicita in AggregationPeriod.

I periodi di aggregazione oraria, se supportati da un insieme di metriche, sono sempre specificati in formato UTC per evitare ambiguità relative alle transizioni dell'ora legale, in cui un'ora viene saltata quando viene adottata l'ora legale e ripetuta quando viene abbandonata. Ad esempio, il timestamp "2021-11-07 01:00:00 America/Los_Angeles" è ambiguo, in quanto può corrispondere a "2021-11-07 08:00:00 UTC" o "2021-11-07 09:00:00 UTC".

I periodi di aggregazione giornalieri richiedono la specifica di un fuso orario che determinerà gli istanti precisi di inizio e fine della giornata. Non tutti i set di metriche supportano tutti i fusi orari, quindi assicurati di controllare quali sono supportati dal set di metriche che vuoi interrogare.

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

enum (AggregationPeriod)

Tipo di periodo di aggregazione dei punti dati nella cronologia.

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

object (DateTime)

Il punto dati iniziale della sequenza temporale (incluso). Deve essere allineato al periodo di aggregazione nel seguente modo:

  • ORARIO: i campi "minuti", "secondi" e "nanosecondi" devono essere impostati. timeZone può essere lasciato non impostato (il valore predefinito è UTC) o impostato esplicitamente su "UTC". L'impostazione di qualsiasi altro ID utcOffset o fuso orario genererà un errore di convalida.
  • DAILY: i campi "hours", "minutes", "seconds" e "nanos" devono essere non impostati. Diversi set di metriche supportano diversi fusi orari. Può essere lasciato non impostato per utilizzare il fuso orario predefinito specificato dal set di metriche.

Il fuso orario del punto finale deve corrispondere a quello del punto iniziale.
endTime

object (DateTime)

Il punto dati finale della sequenza temporale (escluso). Per le limitazioni, vedi startTime. Il fuso orario del punto finale deve corrispondere a quello del punto iniziale.

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

(Facoltativo) Etichetta descrittiva per il valore, sempre in inglese. Ad esempio, "Spagna" per il codice paese "ES".

Mentre il valore della dimensione è stabile, questa etichetta del valore è soggetta a modifiche. Non dare per scontato che la relazione (valore, valueLabel) sia stabile. Ad esempio, il codice paese ISO "MK" ha cambiato di recente il nome in "Macedonia del Nord".
Campo unione value. Valore effettivo della dimensione. Dipende dal tipo. value può essere solo uno dei seguenti:
stringValue

string

Valore effettivo, rappresentato come stringa.
int64Value

string (int64 format)

Valore effettivo, rappresentato 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

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

object (Decimal)

Valore effettivo, rappresentato come numero decimale.
Campo 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.

DecimalConfidenceInterval

Rappresenta l'intervallo di confidenza di una metrica.

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

object (Decimal)

Il limite inferiore dell'intervallo di confidenza.
upperBound

object (Decimal)

Il limite superiore dell'intervallo di confidenza.

Metodi

list

 Elenca le anomalie in uno qualsiasi dei set di dati.