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)

המדד שבו זוהתה האנומליה, יחד עם הערך החריג.

לוח זמנים

מפרט של פרמטרי הצבירה הקשורים לזמן.

בצירי הזמן מוגדרת תקופת צבירה (DAILY, HOURLY וכו') שמציינת את אופן הצבירה של אירועים במדדים.

הנקודות בציר הזמן מוגדרות לפי תאריך ההתחלה ותאריך הצבירה של תקופת הצבירה. משך הזמן הוא משתמע בתקופת הצבירה.

בתקופות של צבירה שעתית, אם היא נתמכת על ידי קבוצת מדדים, יש לציין תמיד את השעון UTC כדי למנוע אי בהירות לגבי מעברים בין שעון קיץ לשעון חורף, שבהם המערכת מדלגת על שעה כשהיא משלבת את שעון 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)

נקודת ההתחלה של ציר הזמן (כולל). צריך להתאים אותם לתקופת הצבירה באופן הבא:

  • מדי שעה: יש לבטל את ההגדרה של השדות 'דקות', 'שניות' ו 'ננו'. אפשר להשאיר את השדה TimeZone לא מוגדר (ברירת המחדל היא 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

 מפרטת חריגות בכל אחד ממערכי הנתונים.