REST Resource: anomalies

แหล่งข้อมูล: ความผิดปกติ

แสดงความผิดปกติที่ตรวจพบในชุดข้อมูล

ระบบการตรวจจับความผิดปกติของเราจะระบุจุดข้อมูลในอนุกรมเวลาที่อยู่นอกช่วงและช่วงที่คาดหวังซึ่งได้มาจากข้อมูลย้อนหลัง แม้ว่าช่วงที่คาดหวังเหล่านั้นจะมีขอบเขตบนและล่างสุด แต่เราจะรายงานความผิดปกติเมื่อข้อมูลล้มเหลวโดยไม่คาดคิด ซึ่งมักจะสอดคล้องกับกรณีที่เมตริกข้ามขอบเขตด้านบน

ระบบจะจัดกลุ่มจุดข้อมูลหลายรายการที่อยู่ติดกันในไทม์ไลน์นอกช่วงที่คาดหวังเป็นความผิดปกติเดียว ดังนั้นความผิดปกติจึงแสดงถึงกลุ่มลําดับเวลาของเมตริกอย่างมีประสิทธิภาพ ข้อมูลที่จัดเก็บใน timelineSpec, dimensions และ metric สามารถใช้เพื่อดึงไทม์ไลน์แบบเต็มที่มีการขยายเพิ่มเติมตามบริบท

สิทธิ์ที่จําเป็น: ผู้ใช้ที่เรียกใช้นี้ต้องมีสิทธิ์ดูข้อมูลแอป (อ่านอย่างเดียว) สําหรับแอปเพื่อเข้าถึงทรัพยากรนี้

การแสดง JSON 
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
ช่อง
name

string

ชื่อของความผิดปกติ

รูปแบบ: แอป/{app}/ความผิดปกติ/{anomaly}
metricSet

string

เมตริกตั้งค่าทรัพยากรที่ตรวจพบความผิดปกติ
timelineSpec

object (TimelineSpec)

ข้อกําหนดไทม์ไลน์ที่ครอบคลุมระยะเวลาความผิดปกติ
dimensions[]

object (DimensionValue)

ชุดค่าผสมของมิติข้อมูลที่ตรวจพบความผิดปกติ
metric

object (MetricValue)

เมตริกที่ตรวจพบความผิดปกติร่วมกับค่าที่ผิดปกติ

ไทม์ไลน์

ข้อกําหนดของพารามิเตอร์การรวมที่เกี่ยวข้องกับไทม์ไลน์

ไทม์ไลน์มีระยะเวลาการรวม (DAILY, HOURLY ฯลฯ) ซึ่งจะกําหนดวิธีรวบรวมเหตุการณ์ในเมตริก

คะแนนในไทม์ไลน์กําหนดโดยวันที่และเวลาเริ่มต้นของระยะเวลาการรวม ระยะเวลาจะระบุโดยนัยใน 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"

ระยะเวลาการรวมรายวันต้องระบุเขตเวลาซึ่งจะกําหนด Instant ของช่วงเวลาเริ่มต้นและเวลาสิ้นสุดของวัน ชุดเมตริกบางรายการไม่รองรับเขตเวลาทั้งหมด ดังนั้น โปรดตรวจสอบว่าชุดเมตริกที่คุณต้องการค้นหารองรับเขตเวลาใดบ้าง

การแสดง JSON 
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
ช่อง
aggregationPeriod

enum (AggregationPeriod)

ประเภทระยะเวลาการรวมของจุดข้อมูลในไทม์ไลน์

ช่วงที่ระบุจะระบุไว้ในวันที่และเวลาที่จุดเริ่มต้นของช่วงเวลา
startTime

object (DateTime)

เริ่มจุดข้อมูลของไทม์ไลน์ (รวม) ต้องสอดคล้องกับระยะเวลาการรวมดังนี้

  • รายชั่วโมง: ต้องยกเลิกช่อง "นาที" "วินาที" และ "นาโน" จะเว้นว่างเขตเวลาได้ (ค่าเริ่มต้นเป็น UTC) หรือตั้งค่าเป็น "UTC" อย่างชัดแจ้ง การตั้งค่า utcOFFset หรือรหัสเขตเวลาอื่นๆ จะทําให้เกิดข้อผิดพลาดในการตรวจสอบ
  • ทุกวัน: ต้องยกเลิกช่อง "ชั่วโมง" "นาที" "วินาที" และ "นาโน" ชุดเมตริกต่างๆ รองรับเขตเวลาที่ต่างกัน ไม่ได้ตั้งค่าให้สามารถใช้เขตเวลาเริ่มต้นที่กําหนดโดยชุดเมตริก

เขตเวลาของจุดสิ้นสุดต้องตรงกับเขตเวลาของจุดเริ่มต้น
endTime

object (DateTime)

จุดสิ้นสุดจุดข้อมูลของไทม์ไลน์ (ไม่รวม) ดูข้อจํากัดเริ่มต้น เขตเวลาของจุดสิ้นสุดต้องตรงกับเขตเวลาของจุดเริ่มต้น

ค่ามิติข้อมูล

แสดงค่าของมิติข้อมูลเดียว

การแสดง 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" ได้เปลี่ยนชื่อเป็น "North Macedonia" เมื่อเร็วๆ นี้
ช่อง Union 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

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

object (Decimal)

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

object (DecimalConfidenceInterval)

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

ช่วงความเชื่อมั่นแบบทศนิยม

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

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

object (Decimal)

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

object (Decimal)

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

วิธีการ

list

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