REST Resource: anomalies

Recurso: Anomalía

Representa una anomalía detectada en un conjunto de datos.

Nuestros sistemas de detección de anomalías marcan los puntos de datos de una serie temporal que se encuentra fuera del rango esperado y que deriva de los datos históricos. Aunque esos rangos esperados tienen un límite superior y uno inferior, solo marcamos anomalías cuando los datos se vuelven peor de forma inesperada, lo que suele corresponder con el caso en el que la métrica cruza el límite superior.

Si hay varios datos contiguos en un cronograma que esté fuera del rango esperado, se agruparán en una sola anomalía. Por lo tanto, una anomalía representa efectivamente un segmento del cronograma de una métrica. La información almacenada en timelineSpec, dimensions y metric se puede usar a fin de recuperar un cronograma completo con rigurosidad extendida para brindar contexto.

Permisos necesarios: para acceder a este recurso, el usuario que realiza la llamada necesita el permiso Ver información de la aplicación (solo lectura).

Representación JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Campos
name

string

Nombre de la anomalía.

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

string

Recurso de conjunto de métricas donde se detectó la anomalía.
timelineSpec

object (TimelineSpec)

Especificación de cronograma que cubre el período de la anomalía.
dimensions[]

object (DimensionValue)

Es la combinación de dimensiones en las que se detectó la anomalía.
metric

object (MetricValue)

Es la métrica en la que se detectó la anomalía, junto con el valor anómalo.

Especificación de cronograma

Especificación de los parámetros de agregación relacionados con el tiempo de un cronograma.

Los cronogramas tienen un período de agregación (DAILY, HOURLY, etc.) que define cómo se agregan los eventos en las métricas.

Los puntos en un cronograma se definen por la fecha y hora de inicio del período de agregación. La duración está implícita en el AggregationPeriod.

Los períodos de agregación por hora, cuando son compatibles con un conjunto de métricas, siempre se especifican en UTC para evitar ambigüedades en las transiciones de horario de verano, en las que se omite una hora cuando se adopta DST y se repite cuando se abandona DST. Por ejemplo, la marca de tiempo "2021-11-07 01:00:00 America/Los_Angeles" es ambigua, ya que puede corresponder a 2021-11-07 08:00:00 UTC o a 2021-11-07 09:00:00 UTC.

Los períodos de agregación diarios requieren que se especifique una zona horaria que determinará los instantes precisos de inicio y fin del día. No todos los conjuntos de métricas admiten todas las zonas horarias, por lo que debe asegurarse de comprobar qué zonas horarias son compatibles con el conjunto de métricas que desea consultar.

Representación JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Campos
aggregationPeriod

enum (AggregationPeriod)

Tipo de período de agregación de los datos en el cronograma.

Los intervalos se identifican según la fecha y la hora del comienzo del intervalo.
startTime

object (DateTime)

Punto de inicio de inicio del cronograma (inclusive). Se debe alinear al período de agregación de la siguiente manera:

  • HORARIO: Se deben desactivar los campos "minutos", "segundos" y "nanos". La zona horaria no se puede establecer (la configuración predeterminada es UTC) o se establece explícitamente en "UTC". Si configuras cualquier otro ID de utcOffset o zona horaria, se producirá un error de validación.
  • DIARIO: No se deben configurar los campos "horas", "minutos", "segundos" y "nanos". Los diferentes conjuntos de métricas admiten zonas horarias diferentes. Si no la estableces, se usará la zona horaria predeterminada que especificó el conjunto de métricas.

La zona horaria del punto de destino debe coincidir con la del punto de partida.
endTime

object (DateTime)

Punto final de datos del cronograma (exclusivo). Consulta startTime para conocer las restricciones. La zona horaria del punto de destino debe coincidir con la del punto de partida.

DimensionValue

Representa el valor de una sola dimensión.

Representación 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.
}
Campos
dimension

string

Nombre de la dimensión.
valueLabel

string

Opcional. Es una etiqueta sencilla para el valor, siempre en inglés. Por ejemplo, “España” para el código de país “ES”.

Mientras que el valor de dimensión es estable, esta etiqueta de valor está sujeta a cambios. No supongas que la relación (valor, valorLabel) es estable. Por ejemplo, el nombre del código ISO de país “MK” cambió recientemente a “Macedonia del Norte”.
Campo de unión value. Valor real de la dimensión. Depende del tipo. Las direcciones (value) solo pueden ser una de las siguientes opciones:
stringValue

string

Valor real, representado como una string.
int64Value

string (int64 format)

Valor real, representado como un int64.

MetricValue

Representa el valor de una métrica.

Representación 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.
}
Campos
metric

string

Nombre de la métrica.
Campo de unión value. Valor real de la métrica. Depende del tipo. Las direcciones (value) solo pueden ser una de las siguientes opciones:
decimalValue

object (Decimal)

Valor real, representado como un número decimal.
Campo de unión confidence_interval. Si se proporciona, representa un intervalo de confianza para el valor. Las direcciones (confidence_interval) solo pueden ser una de las siguientes opciones:
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Intervalo de confianza de un valor que es del tipo type.Decimal.

Intervalo de confianza decimal

Representa el intervalo de confianza de una métrica.

Representación JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Campos
lowerBound

object (Decimal)

El límite inferior del intervalo de confianza.
upperBound

object (Decimal)

El límite superior del intervalo de confianza.

Métodos

list

 Muestra las anomalías en cualquiera de los conjuntos de datos.