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 וכו') שמגדירה איך האירועים נצברים במדדים.

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

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

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

  • שעתי: השדות minutes,‏ seconds ו-nanos צריכים להיות לא מוגדרים. אפשר להשאיר את timeZone ללא הגדרה (ברירת המחדל היא UTC) או להגדיר אותו באופן מפורש ל-UTC. הגדרת ערך אחר של utcOffset או של מזהה אזור זמן תגרום לשגיאת אימות.
  • 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)

הגבול העליון של הרווח הבר-סמך.

Methods

list

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