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 ฯลฯ) ซึ่งกำหนดวิธีรวบรวมเหตุการณ์ในเมตริก

จุดในไทม์ไลน์กำหนดโดย DateTime เริ่มต้นของระยะเวลาการรวม ระยะเวลาจะอยู่ใน AggregationPeriod โดยปริยาย

เมื่อชุดเมตริกรองรับ ช่วงการรวมรายชั่วโมงจะระบุเป็น UTC เสมอเพื่อหลีกเลี่ยงความคลุมเครือเกี่ยวกับการเปลี่ยนเวลาออมแสง ซึ่งจะข้าม 1 ชั่วโมงเมื่อใช้ DST และจะทำซ้ำเมื่อเลิกใช้ 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 หรือรหัสเขตเวลาอื่นๆ จะทำให้เกิดข้อผิดพลาดในการตรวจสอบความถูกต้อง
  • รายวัน: ต้องไม่ได้ตั้งค่าฟิลด์ "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" เปลี่ยนชื่อเป็น "มาซิโดเนียเหนือ" เมื่อเร็วๆ นี้
ฟิลด์ Union 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

ชื่อเมตริก
ฟิลด์ Union value ค่าจริงของเมตริก ขึ้นอยู่กับประเภท value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
decimalValue

object (Decimal)

ค่าจริงซึ่งแสดงเป็นตัวเลขฐาน 10
ฟิลด์ Union confidence_interval หากระบุไว้ จะแสดงช่วงความเชื่อมั่นสำหรับค่า confidence_interval ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
decimalValueConfidenceInterval

object (DecimalConfidenceInterval)

ช่วงความเชื่อมั่นของค่าที่เป็นประเภท type.Decimal

DecimalConfidenceInterval

แสดงช่วงความเชื่อมั่นของเมตริก

การแสดง JSON 
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
ช่อง
lowerBound

object (Decimal)

ขอบเขตล่างของช่วงความเชื่อมั่น
upperBound

object (Decimal)

ขอบเขตบนของช่วงความเชื่อมั่น

เมธอด

list

 แสดงรายการความผิดปกติในชุดข้อมูล