REST Resource: anomalies

Ressource: Anomalie

Représente une anomalie détectée dans un ensemble de données.

Nos systèmes de détection d'anomalies signalent des points de données dans une série temporelle qui se situe en dehors de la plage attendue et provient de données historiques. Bien que les plages attendues aient des limites supérieure et inférieure, nous ne signalons les anomalies que lorsque les données sont devenues de moins faibles, ce qui correspond généralement au cas où la métrique dépasse la limite supérieure.

Plusieurs points de données contigus d'une chronologie qui sont en dehors de la plage prévue seront regroupés en une seule anomalie. Une anomalie représente donc un segment de la chronologie d'une métrique. Les informations stockées dans timelineSpec, dimensions et metric peuvent être utilisées pour récupérer une chronologie complète avec une plage étendue de contexte.

Autorisations requises: pour accéder à cette ressource, l'utilisateur appelant doit disposer de l'autorisation Afficher les informations de l'application (lecture seule).

Représentation JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Champs
name

string

Nom de l'anomalie.

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

string

Ressource de l'ensemble de métriques où l'anomalie a été détectée.
timelineSpec

object (TimelineSpec)

Spécification de chronologie qui couvre la période d'anomalie.
dimensions[]

object (DimensionValue)

Combinaison des dimensions dans lesquelles l'anomalie a été détectée.
metric

object (MetricValue)

Métrique dans laquelle l'anomalie a été détectée, avec la valeur anormale.

Spécification de chronologie

Spécification des paramètres d'agrégation temporel d'une chronologie.

La chronologie inclut une période d'agrégation (DAILY, HOURLY, etc.) qui définit la manière dont les événements sont agrégés dans les métriques.

Les points d'une chronologie sont définis par la date et l'heure de début de la période d'agrégation. La durée est implicite dans AggregationPeriod.

Les périodes d'agrégation horaire, lorsqu'elles sont compatibles avec un ensemble de métriques, sont toujours spécifiées en temps UTC afin d'éviter les ambiguïtés lors des passages à l'heure d'été, où une heure est ignorée lors de l'adoption de l'heure d'été. Par exemple, l'horodatage "2021-11-07 01:00:00 America/Los_Angeles" est ambigu, car il peut correspondre à "2021-11-07 08:00:00 UTC" ou "2021-11-07 09:00:00 UTC".

Les périodes d'agrégation quotidiennes nécessitent de spécifier un fuseau horaire qui déterminera les moments précis du début et de la fin de la journée. Certains ensembles de métriques ne sont pas compatibles avec tous les fuseaux horaires. Veillez donc à vérifier ceux compatibles avec l'ensemble de métriques que vous souhaitez interroger.

Représentation JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Champs
aggregationPeriod

enum (AggregationPeriod)

Type de période d'agrégation des points de données dans la timeline.

Les intervalles sont identifiés par la date et l'heure indiquées au début de l'intervalle.
startTime

object (DateTime)

Point de données de départ de la timeline (inclus). Doit être aligné sur la période d'agrégation comme suit:

  • HOURLY: les champs "minutes", "seconds" et "nanos" ne doivent pas être définis. Le fuseau horaire peut être laissé défini (par défaut, UTC) ou explicitement défini sur "UTC". Si vous définissez un autre identifiant utcOffset ou timezone, une erreur de validation se produit.
  • QUOTIDIEN: les champs "heures", "minutes", "secondes" et "nanos" ne doivent pas être définis. Différents ensembles de métriques sont compatibles avec des fuseaux horaires différents. Il n'est pas possible d'utiliser le fuseau horaire par défaut spécifié par l'ensemble de métriques.

Le fuseau horaire du point d'arrivée doit correspondre à celui du point de départ.
endTime

object (DateTime)

Point de données de fin de la timeline (exclusif). Consultez la section startTime pour connaître les restrictions. Le fuseau horaire du point d'arrivée doit correspondre à celui du point de départ.

DimensionValue

Représente la valeur d'une seule dimension.

Représentation 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.
}
Champs
dimension

string

Nom de la dimension.
valueLabel

string

Facultatif. Libellé convivial pour la valeur, toujours en anglais. Par exemple, "Espagne" pour le code pays "ES".

La valeur de la dimension est stable, mais son libellé est susceptible de changer. Ne partez pas du principe que la relation (value, valueLabel) est stable. Par exemple, le code de pays ISO "MK" a récemment été renommé "Macédoine du Nord".
Champ d'union value. Valeur réelle de la dimension. Type dépendant value ne peut être qu'un des éléments suivants :
stringValue

string

Valeur réelle, représentée par une chaîne.
int64Value

string (int64 format)

Valeur réelle, représentée par un nombre entier 64.

MetricValue

Représente la valeur d'une métrique.

Représentation 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.
}
Champs
metric

string

Nom de la métrique.
Champ d'union value. Valeur réelle de la métrique. Type dépendant value ne peut être qu'un des éléments suivants :
decimalValue

object (Decimal)

Valeur réelle, représentée par un nombre décimal.
Champ d'union confidence_interval. Si ce champ est donné, représente un intervalle de confiance pour la valeur. confidence_interval ne peut être qu'un des éléments suivants :
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

Intervalle de confiance d'une valeur de type type.Decimal.

Intervalle de confiance décimal

Représente l'intervalle de confiance d'une métrique.

Représentation JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Champs
lowerBound

object (Decimal)

Limite inférieure de l'intervalle de confiance.
upperBound

object (Decimal)

Limite supérieure de l'intervalle de confiance.

Méthodes

list

 Répertorie les anomalies dans n'importe quel ensemble de données.