REST Resource: anomalies

संसाधन: Anomaly

किसी डेटासेट में मिली गड़बड़ी को दिखाता है.

गड़बड़ी का पता लगाने वाले हमारे सिस्टम, टाइम सीरीज़ में मौजूद उन डेटापॉइंट को फ़्लैग करते हैं जो पुराने डेटा से मिली अनुमानित रेंज से बाहर होते हैं. अनुमानित रेंज में ज़्यादा और कम, दोनों तरह की सीमाएं होती हैं. हालांकि, हम सिर्फ़ तब अनियमितताओं को फ़्लैग करते हैं, जब डेटा उम्मीद से ज़्यादा खराब हो जाता है. आम तौर पर, ऐसा तब होता है, जब मेट्रिक, ऊपरी सीमा को पार कर जाती है.

अगर टाइमलाइन में, अनुमानित सीमा से बाहर के कई डेटापॉइंट एक साथ मौजूद हैं, तो उन्हें एक ही गड़बड़ी के तौर पर ग्रुप किया जाएगा. इसलिए, किसी मेट्रिक की टाइमलाइन के सेगमेंट को विसंगति के तौर पर दिखाया जाता है. 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 में शामिल होती है.

जब मेट्रिक सेट में हर घंटे के हिसाब से डेटा इकट्ठा करने की सुविधा काम करती है, तब समयसीमा हमेशा यूटीसी में तय की जाती है. इससे डेलाइट सेविंग टाइम (डीएसटी) में बदलाव के दौरान होने वाली समस्याओं से बचा जा सकता है. डीएसटी को अपनाने पर एक घंटे का समय आगे बढ़ जाता है और डीएसटी को बंद करने पर एक घंटे का समय पीछे चला जाता है. उदाहरण के लिए, टाइमस्टैंप '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" पर सेट किया जा सकता है. utcOffset या timezone id की कोई अन्य वैल्यू सेट करने पर, पुष्टि करने से जुड़ी गड़बड़ी होगी.
  • 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) का संबंध स्थिर है. उदाहरण के लिए, आईएसओ देश कोड 'MK' का नाम हाल ही में बदलकर 'North Macedonia' कर दिया गया है.
यूनियन फ़ील्ड 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)

कॉन्फ़िडेंस इंटरवल की ऊपरी सीमा.

तरीके

list

 किसी भी डेटासेट में मौजूद गड़बड़ियों की सूची बनाता है.