- Risorsa: Anomalia
- Sequenza temporale
- Valore dimensione
- Valore metrica
- DecimalConfidenceInterval
- Metodi
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 ( |
Campi | |
---|---|
name |
Nome dell'anomalia. Formato: apps/{app}/anomalies/{anomaly} |
metricSet |
Risorsa del set di metriche in cui è stata rilevata l'anomalia. |
timelineSpec |
Specifica della sequenza temporale che riguarda il periodo dell'anomalia. |
dimensions[] |
Combinazione di dimensioni in cui è stata rilevata l'anomalia. |
metric |
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 ( |
Campi | |
---|---|
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 |
Punto di dati iniziale della sequenza temporale (inclusivo). Deve essere in linea con il periodo di aggregazione come segue:
Il fuso orario del punto di arrivo deve corrispondere al fuso orario del punto di partenza. |
endTime |
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 |
Campi | |
---|---|
dimension |
Nome della dimensione. |
valueLabel |
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 |
Il valore effettivo, rappresentato da una stringa. |
int64Value |
Il valore effettivo, indicato come int64. |
MetricValue
Rappresenta il valore di una metrica.
Rappresentazione JSON |
---|
{ "metric": string, // Union field |
Campi | |
---|---|
metric |
Il nome della metrica. |
Campo di unione value . Valore effettivo della metrica. Dipende dal tipo. value può essere solo uno dei seguenti: |
|
decimalValue |
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 |
Intervallo di confidenza di un valore di tipo |
Intervallo di confidenza decimale
Rappresenta l'intervallo di confidenza di una metrica.
Rappresentazione JSON |
---|
{ "lowerBound": { object ( |
Campi | |
---|---|
lowerBound |
Limite inferiore dell'intervallo di confidenza. |
upperBound |
Il limite superiore dell'intervallo di confidenza. |
Metodi |
|
---|---|
|
Elenca le anomalie in qualsiasi set di dati. |