REST Resource: anomalies

리소스: Anomaly

데이터 세트에서 감지된 이상치를 나타냅니다.

이상 감지 시스템은 시계열에서 과거 데이터에서 파생된 예상 범위를 벗어나는 데이터 포인트를 표시합니다. 예상 범위에는 상한과 하한이 있지만 데이터가 예상치 못하게 악화된 경우에만 이상치가 표시됩니다. 이는 일반적으로 측정항목이 상한을 초과하는 경우에 해당합니다.

타임라인에서 예상 범위를 벗어나는 연속된 데이터 포인트가 여러 개 있으면 단일 이상치로 그룹화됩니다. 따라서 이상치는 측정항목 타임라인의 세그먼트를 효과적으로 나타냅니다. 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 등)이 있습니다.

타임라인의 포인트는 집계 기간의 시작 DateTime으로 정의됩니다. 기간은 AggregationPeriod에 암시적으로 포함됩니다.

측정항목 세트에서 지원하는 경우 시간별 집계 기간은 항상 UTC로 지정됩니다. 이는 DST를 채택할 때 1시간이 건너뛰고 DST를 포기할 때 반복되는 일광 절약 시간 전환과 관련된 모호성을 방지하기 위해서입니다. 예를 들어 타임스탬프 '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: 'minutes', 'seconds', 'nanos' 필드는 설정되지 않아야 합니다. timeZone은 설정되지 않은 상태로 둘 수 있으며 (기본값은 UTC) 명시적으로 'UTC'로 설정할 수도 있습니다. 다른 utcOffset 또는 timezone id를 설정하면 유효성 검사 오류가 발생합니다.
  • DAILY: 'hours', 'minutes', 'seconds', 'nanos' 필드는 설정되지 않아야 합니다. 측정항목 세트마다 지원하는 시간대가 다릅니다. 측정항목 세트에서 지정한 기본 시간대를 사용하도록 설정되지 않은 상태로 둘 수 있습니다.

종료 지점의 시간대는 시작 지점의 시간대와 일치해야 합니다.
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 유형 값의 신뢰 구간입니다.

DecimalConfidenceInterval

측정항목의 신뢰 구간을 나타냅니다.

JSON 표현 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
필드
lowerBound

object (Decimal)

신뢰 구간의 하한입니다.
upperBound

object (Decimal)

신뢰 구간의 상한입니다.

메서드

list

 데이터 세트의 이상치를 나열합니다.