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 )

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

  • HOURLY: поля «минуты», «секунды» и «нано» должны быть не заданы. TimeZone можно не задавать (по умолчанию 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

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

Хотя значение измерения стабильно, метка этого значения может меняться. Не следует предполагать, что отношение (value, valueLabel) стабильно. Например, код страны 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

 Перечисляет аномалии в любом из наборов данных.