REST Resource: anomalies

Ресурс: Аномалия

Представляет собой аномалию, обнаруженную в наборе данных.

Наши системы обнаружения аномалий отмечают точки данных во временном ряду, которые выходят за пределы ожидаемого диапазона, рассчитанного на основе исторических данных. Хотя эти ожидаемые диапазоны имеют верхнюю и нижнюю границы, мы отмечаем аномалии только тогда, когда данные неожиданно ухудшаются , что обычно соответствует случаю, когда показатель пересекает верхнюю границу.

Несколько смежных точек данных на временной шкале, выходящих за пределы ожидаемого диапазона, будут сгруппированы в одну аномалию. Таким образом, аномалия фактически представляет собой сегмент временной шкалы метрики. Информация, хранящаяся в timelineSpec , dimensions и metric может быть использована для получения полной временной шкалы с расширенным диапазоном для контекста.

Необходимые разрешения : для доступа к этому ресурсу вызывающему пользователю требуется разрешение на просмотр информации о приложении (только для чтения) .

JSON-представление 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
Поля
name

string

Идентификатор. Название аномалии.

Формат: apps/{app}/anomalies/{anomaly}

metricSet

string

Ресурс набора метрик, где была обнаружена аномалия.

timelineSpec

object ( TimelineSpec )

Описание временной шкалы, охватывающее период возникновения аномалии.

dimensions[]

object ( DimensionValue )

Сочетание параметров, в котором была обнаружена аномалия.

metric

object ( MetricValue )

Метрика, в которой была обнаружена аномалия, вместе с аномальным значением.

TimelineSpec

Указание параметров агрегирования временной шкалы, связанных со временем.

Временные шкалы имеют период агрегирования ( DAILY , HOURLY и т. д.), который определяет, как события агрегируются в метриках.

Точки на временной шкале определяются начальной датой и временем периода агрегирования. Длительность задается неявно в параметре AggregationPeriod.

Периоды почасовой агрегации, если они поддерживаются набором метрик, всегда указываются в формате UTC, чтобы избежать неоднозначностей, связанных с переходом на летнее время, когда час пропускается при переходе на летнее время и повторяется при его отмене. Например, метка времени '2021-11-07 01:00:00 America/Los_Angeles' является неоднозначной, поскольку она может соответствовать '2021-11-07 08:00:00 UTC' или '2021-11-07 09:00:00 UTC'.

Для агрегирования данных за сутки необходимо указать часовой пояс, который определит точные моменты начала и конца дня. Не все наборы метрик поддерживают все часовые пояса, поэтому убедитесь, что вы проверили, какие часовые пояса поддерживаются тем набором метрик, к которому вы хотите обращаться.

JSON-представление 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
Поля
aggregationPeriod

enum ( AggregationPeriod )

Необязательный параметр. Тип периода агрегирования точек данных на временной шкале.

Интервалы определяются датой и временем начала интервала.

startTime

object ( DateTime )

Необязательно. Начальная точка данных временной шкалы (включительно). Должна быть выровнена по периоду агрегирования следующим образом:

  • ЕЖЕЧАСНО: поля «минуты», «секунды» и «нанос» должны быть не заданы. Часовой пояс можно оставить неуказанным (по умолчанию UTC) или явно указать «UTC». Установка любого другого значения utcOffset или идентификатора часового пояса приведет к ошибке проверки.
  • ЕЖЕДНЕВНО: поля «часы», «минуты», «секунды» и «наносы» должны быть не заданы. Различные наборы метрик поддерживают разные часовые пояса. Их можно оставить неуказанными, чтобы использовать часовой пояс по умолчанию, указанный в наборе метрик.

Часовой пояс конечной точки должен совпадать с часовым поясом начальной точки.

endTime

object ( DateTime )

Необязательно. Конечная точка данных временной шкалы (исключая указанную). См. startTime для получения информации об ограничениях. Часовой пояс конечной точки должен совпадать с часовым поясом начальной точки.

DimensionValue

Представляет значение одного измерения.

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.
}
Поля
dimension

string

Название измерения.

valueLabel

string

Необязательно. Удобное для человека обозначение значения, всегда на английском языке. Например, «Spain» для кода страны «ES».

В то время как значение измерения стабильно, эта метка значения может изменяться. Не следует предполагать, что связь (значение, метка значения) стабильна. Например, код страны ISO «MK» недавно изменил свое название на «Северная Македония».

value поля объединения. Фактическое значение измерения. Зависит от типа. value может быть только одним из следующих:
stringValue

string

Фактическое значение, представленное в виде строки.

int64Value

string ( int64 format)

Фактическое значение, представленное в виде целого числа int64.

MetricValue

Представляет значение показателя.

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.
}
Поля
metric

string

Название показателя.

value поля объединения. Фактическое значение метрики. Зависит от типа. value может быть только одним из следующих:
decimalValue

object ( Decimal )

Фактическое значение, представленное в виде десятичного числа.

Поле объединения confidence_interval . Если задано, представляет собой доверительный интервал для значения. confidence_interval может принимать только одно из следующих значений:
decimalValueConfidenceInterval

object ( DecimalConfidenceInterval )

Доверительный интервал значения типа type.Decimal .

Десятичный доверительный интервал

Представляет собой доверительный интервал показателя.

JSON-представление 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
Поля
lowerBound

object ( Decimal )

Нижняя граница доверительного интервала.

upperBound

object ( Decimal )

Верхняя граница доверительного интервала.

Методы

list

 Выводит список аномалий в любом из наборов данных.