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

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