REST Resource: anomalies

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

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

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

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

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

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

string

Название аномалии.

Формат: приложения/{приложение}/аномалии/{аномалии}

metricSet

string

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

timelineSpec

object ( TimelineSpec )

Спецификация временной шкалы, которая охватывает период аномалии.

dimensions[]

object ( DimensionValue )

Комбинация измерений, в которых была обнаружена аномалия.

metric

object ( MetricValue )

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

Спецификация временной шкалы

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

Временные шкалы имеют период агрегирования ( 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 для ограничений. Часовой пояс конечной точки должен соответствовать часовому поясу начальной точки.

ПараметрЗначение

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

Представление 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.

МетрикаЗначение

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

Представление 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

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