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

אופציונלי. תווית ידידותית למשתמש לערך, תמיד באנגלית. לדוגמה, 'Spain' לציון קוד המדינה '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

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