REST Resource: anomalies

Risorsa: Anomaly

Rappresenta un'anomalia rilevata in un set di dati.

I nostri sistemi di rilevamento delle anomalie contrassegnano i punti dati in 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, contrassegniamo le anomalie solo quando i dati sono diventati inaspettatamente peggiori, il che di solito corrisponde al caso in cui la metrica supera il limite superiore.

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

Autorizzazioni richieste: per accedere a questa risorsa, l'utente che chiama 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. Il 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 relativi al tempo di una sequenza temporale.

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 dall'ora di inizio del periodo di aggregazione. La durata è implicita in AggregationPeriod.

I periodi di aggregazione oraria, se supportati da un set di metriche, vengono sempre specificati in formato UTC per evitare ambiguità relative alle transizioni dell'ora legale, in cui un'ora viene saltata quando si adotta l'ora legale e 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".

I periodi di aggregazione giornaliera 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 fusi orari sono supportati dal set di metriche su cui vuoi eseguire query.

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

enum (AggregationPeriod)

Facoltativo. 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)

Facoltativo. Punto dati iniziale della sequenza temporale (incluso). Deve essere allineato al periodo di aggregazione come segue:

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

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

object (DateTime)

Facoltativo. Punto dati finale della sequenza temporale (escluso). Per le limitazioni, vedi startTime. 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

Facoltativo. Etichetta descrittiva per il valore, sempre in inglese. Ad esempio, "Spain" 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, etichetta del valore) sia stabile. Ad esempio, il codice paese ISO "MK" ha cambiato di recente il suo nome in "Macedonia del Nord".
Campo unione value. Valore effettivo della dimensione. Dipendente dal tipo. value può essere solo uno dei seguenti tipi:
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. Dipendente dal tipo. value può essere solo uno dei seguenti tipi:
decimalValue

object (Decimal)

Valore effettivo, rappresentato come numero decimale.
Campo unione confidence_interval. Se specificato, rappresenta un intervallo di affidabilità per il valore. confidence_interval può essere solo uno dei seguenti tipi:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Intervallo di affidabilità di un valore di tipo type.Decimal.

DecimalConfidenceInterval

Rappresenta l'intervallo di affidabilità 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.