REST Resource: anomalies

संसाधन: गड़बड़ी

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

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

उम्मीद की सीमा से बाहर की टाइमलाइन में, एक साथ जुड़े कई डेटापॉइंट को एक गड़बड़ी के तौर पर ग्रुप किया जाएगा. इसलिए, यह गड़बड़ी किसी मेट्रिक की समयावधि के सेगमेंट को असरदार तरीके से दिखाती है. timelineSpec, dimensions, और metric में सेव की गई जानकारी का इस्तेमाल, पूरी जानकारी के साथ टाइमलाइन के लिए किया जा सकता है.

ज़रूरी अनुमतियां: इस संसाधन को ऐक्सेस करने के लिए, कॉल करने वाले उपयोगकर्ता को ऐप्लिकेशन के लिए ऐप्लिकेशन की जानकारी देखना (रीड ओनली ऐक्सेस) की अनुमति चाहिए.

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "metricSet": string,
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    {
      object (DimensionValue)
    }
  ],
  "metric": {
    object (MetricValue)
  }
}
फ़ील्ड
name

string

गड़बड़ी का नाम.

फ़ॉर्मैट: ऐप्लिकेशन/{app}/anomalies/{anomaly}

metricSet

string

मेट्रिक सेट रिसॉर्स, जहां गड़बड़ी का पता चला था.

timelineSpec

object (TimelineSpec)

गड़बड़ी की जानकारी वाली टाइमलाइन की जानकारी.

dimensions[]

object (DimensionValue)

उन डाइमेंशन का कॉम्बिनेशन जिनमें गड़बड़ी की पहचान की गई थी.

metric

object (MetricValue)

ऐसी मेट्रिक जिसमें अनियमित मान के साथ गड़बड़ी का पता चला था.

टाइमलाइन स्पेक

टाइमलाइन के समय से जुड़े एग्रीगेशन पैरामीटर की जानकारी.

टाइमलाइन में एग्रीगेशन का समय (DAILY, HOURLY वगैरह) होता है. इससे यह पता चलता है कि इवेंट मेट्रिक में कैसे एग्रीगेट किए जाते हैं.

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

हर घंटे के हिसाब से एग्रीगेशन की अवधि, मेट्रिक सेट के साथ तय की जाती है. इससे, डेलाइट सेविंग टाइम ट्रांज़िशन के दौरान यूटीसी में जानकारी मिलती है, जहां डीएसटी का इस्तेमाल करने के दौरान एक घंटे की छूट होती है. डीएसटी का इस्तेमाल बंद करने के बाद, यह अवधि दोहराई जाती है. उदाहरण के लिए, टाइमस्टैंप '2021-11-07 01:00:00 America/Los_Angeles' को साफ़ तौर पर पता नहीं है, क्योंकि यह '2021-11-07 08:00:00 UTC' या '2021-11-07 09:00:00 यूटीसी' के मुताबिक हो सकता है.

इकट्ठा करने की हर दिन के समय के लिए एक समय क्षेत्र तय करना ज़रूरी है. इस समय सीमा से शुरू होने और दिन के खत्म होने के सटीक समय की जानकारी मिलती है. सभी मेट्रिक सेट, सभी समय क्षेत्रों के साथ काम नहीं करते. इसलिए, पक्का करें कि आप जिस मेट्रिक सेट के बारे में क्वेरी करना चाहते हैं उसमें कौनसा समय क्षेत्र काम करता हो.

जेएसओएन के काेड में दिखाना
{
  "aggregationPeriod": enum (AggregationPeriod),
  "startTime": {
    object (DateTime)
  },
  "endTime": {
    object (DateTime)
  }
}
फ़ील्ड
aggregationPeriod

enum (AggregationPeriod)

टाइमलाइन में डेटापॉइंट के एग्रीगेशन के समय का टाइप.

इंटरवल की पहचान, इंटरवल की शुरुआत में तारीख और समय से होती है.

startTime

object (DateTime)

टाइमलाइन का शुरुआती डेटापॉइंट (शामिल है). एग्रीगेशन अवधि के हिसाब से, इस तरह से जोड़ा जाना चाहिए:

  • HOURLY: 'मिनट', 'सेकंड' और ' नैनो' फ़ील्ड अनसेट होनी चाहिए. समय क्षेत्र को सेट नहीं किया जा सकता (डिफ़ॉल्ट रूप से यूटीसी में) या साफ़ तौर पर "यूटीसी" पर सेट किया जा सकता है. कोई अन्य utcoffset या समय क्षेत्र आईडी सेट करने से एक पुष्टि गड़बड़ी होगी.
  • रोज़: 'घंटे', 'मिनट', 'सेकंड' और 'नैनो' फ़ील्ड अनसेट होनी चाहिए. अलग-अलग मेट्रिक सेट, अलग-अलग समय क्षेत्रों के साथ काम करते हैं. इसे मेट्रिक सेट में बताए गए डिफ़ॉल्ट समय क्षेत्र का इस्तेमाल करने के लिए सेट नहीं किया जा सकता.

समाप्ति बिंदु का समय क्षेत्र, प्रारंभ बिंदु के समय क्षेत्र से मेल खाना चाहिए.

endTime

object (DateTime)

टाइमलाइन का आखिरी डेटापॉइंट (खास तौर पर). पाबंदियों के बारे में जानने के लिए, StartTime पर जाएं. समाप्ति बिंदु का समय क्षेत्र, प्रारंभ बिंदु के समय क्षेत्र से मेल खाना चाहिए.

डाइमेंशन की वैल्यू

किसी एक डाइमेंशन की वैल्यू दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "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

ज़रूरी नहीं. वैल्यू के लिए मानव-फ़्रेंडली लेबल, हमेशा अंग्रेज़ी में. उदाहरण के लिए, 'स्पेन' देश कोड के लिए 'स्पेन'.

डाइमेंशन की वैल्यू स्थिर होने पर, इस लेबल में बदलाव किया जा सकता है. यह न मानें कि (value, valueLabel) संबंध स्थिर है. उदाहरण के लिए, ISO देश कोड 'MK' का नाम हाल ही में 'उत्तरी मैसेडोनिया' में बदल दिया गया है.

यूनियन फ़ील्ड value. डाइमेंशन की असली वैल्यू. टाइप के हिसाब से. value इनमें से सिर्फ़ एक हो सकता है:
stringValue

string

असल वैल्यू, जिसे स्ट्रिंग के तौर पर दिखाया जाता है.

int64Value

string (int64 format)

असल वैल्यू, जिसे int64 के तौर पर दिखाया जाता है.

मेट्रिक वैल्यू

मेट्रिक की वैल्यू को दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "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 टाइप की वैल्यू का कॉन्फ़िडेंस इंटरवल.

दशमलव-कॉन्फ़्रेंसर इंटरवल

मेट्रिक के कॉन्फ़िडेंस इंटरवल को दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "lowerBound": {
    object (Decimal)
  },
  "upperBound": {
    object (Decimal)
  }
}
फ़ील्ड
lowerBound

object (Decimal)

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

upperBound

object (Decimal)

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

तरीके

list

किसी भी डेटासेट में अनियमितताओं की सूची बनाता है.