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)

이상치가 포함된 이상치가 감지된 측정항목입니다.

타임라인 사양

타임라인의 시간 관련 집계 매개변수 사양

타임라인에는 측정항목에서 이벤트가 집계되는 방식을 정의하는 집계 기간 (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)

타임라인의 시작 데이터 포인트 (포함) 다음과 같이 집계 기간에 맞게 조정해야 합니다.

  • 시간별: '분', '초', '나노' 필드는 설정 해제해야 합니다. 시간대는 설정하지 않거나 (기본값: UTC) 명시적으로 'UTC'로 설정할 수 있습니다. 다른 utcOffset이나 시간대 ID를 설정하면 유효성 검사 오류가 발생합니다.
  • 일일: '시간', '분', '초', '나노' 필드가 설정 해제되어야 합니다. 측정항목 모음마다 다른 시간대를 지원합니다. 측정항목 집합으로 지정된 기본 시간대를 사용하도록 설정하지 않은 상태로 둘 수 있습니다.

종료 지점의 시간대는 시작 지점의 시간대와 일치해야 합니다.
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

선택사항입니다. 사람이 읽을 수 있는 값 라벨(항상 영어) 예를 들어 '스페인' 국가 코드는 '스페인'입니다.

측정기준 값이 안정적이면 이 값 라벨은 변경될 수 있습니다. (값, 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

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