काटो एपीआई - खाता मीट्रिक्स

हम दृढ़ता से अनुशंसा करते हैं कि Cato API का उपयोग शुरू करने से पहले, कृपया Cato API के लिए सहायता नीति की समीक्षा करें।

खाता मीट्रिक्स का अवलोकन

खाता मीट्रिक्स क्वेरी आपको साइटों और एसडीपी उपयोगकर्ताओं के काटो क्लाउड से कनेक्शन की स्थिति और गुणवत्ता का विश्लेषण करने में मदद करती है। यह डेटा साइट और काटो क्लाउड के बीच डीटीएलएस टनल के अंदर के ट्रैफ़िक के लिए है।

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

रिसेलर खातों के लिए, आप काटो एपीआई से जोड़ने वाले प्रत्येक ग्राहक खाते के अंदर अलग-अलग एपीआई कुंजी बना सकते हैं। रेट लिमिटिंग और खाता मीट्रिक्स एपीआई क्वेरी के बारे में अधिक जानकारी के लिए, समझना काटो एपीआई रेट लिमिटिंग देखें।

बकेट ग्रैन्युलैरिटी और एपीआई क्वेरी सीमा के साथ कार्य करना

प्रत्येक खाता मीट्रिक्स एपीआई क्वेरी के लिए लौटाई गई वस्तुओं की अधिकतम सीमा 100,000 है। यदि कोई क्वेरी इस सीमा तक पहुँच जाती है, तो क्वेरी कोई अतिरिक्त डेटा नहीं लौटाती और एक त्रुटि संदेश प्रदर्शित होता है।

काटो इस सीमा की गणना निम्नलिखित तत्वों को गुणा करके करता है:

• कुल साइटों की संख्या प्लस वीपीएन उपयोगकर्ता

• मीटरिक की संख्या (एपीआई लेबल/टेलेमेट्री)

• बकेट की संख्या

दूसरे शब्दों में, (साइटों + वीपीएन उपयोगकर्ताओं) * (मीटरिक) * (बकेट) का योग 100,000 से कम होना चाहिए। उदाहरण के लिए, निम्नलिखित क्वेरी एक त्रुटि उत्पन्न करेगी:

• 10 साइटें

• 140 वीपीएन उपयोगकर्ता

• 5 मीट्रिक

• 150 बकेट

(10 + 140) * 5 * 150 = 112,500 वस्तुएं क्वेरी में। इस उदाहरण में, आप सफलतापूर्वक क्वेरी चलाने के लिए बकेट की संख्या को कम कर सकते हैं।

एपीआई लेबल के प्रकारों के बारे में अधिक जानकारी के लिए, देखें काटो एपीआई - खाता मीट्रिक्स > टाइमसीरीज।

क्वेरी के लिए न्यूनतम ग्रैन्युलैरिटी की गणना

यह अनुभाग क्वेरी के लिए समय-सीमा के आधार पर न्यूनतम ग्रैन्युलैरिटी (बकेट आकार) की गणना कैसे करें इसके बारे में बताता है।

1. समय सीमा - समय सीमा को सेकंड में बदलें

2. बकेट लिमिट - 100000 / ( (साइटें + वीपीएन उपयोगकर्ता) * (मीटरिक) ) के आधार पर बकेट लिमिट की गणना करें

3. न्यूनतम ग्रैन्युलैरिटी = (समय सीमा) / (बकेट लिमिट)

उदाहरण के लिए, नीचे दी गई तालिका में पहली पंक्ति में 7 दिन, 100 साइटें और वीपीएन उपयोगकर्ता के लिए क्वेरी सीमा दिखाती है, 5 मीट्रिक के साथ:

• 7 दिन = 604,800 सेकंड

• 200 बकेट = 10000 / (100) * (5)

• 3024 सेकंड न्यूनतम ग्रैन्युलैरिटी = 604800 / 200

निम्नलिखित तालिका में खाता मीट्रिक्स क्वेरी के लिए न्यूनतम बकेट ग्रैन्युलैरिटी के साथ नमूना सेटिंग्स दिखाती है:

खाता मीट्रिक्स फ़ील्ड्स के लिए विवरण

यह वे विवरण हैं जिन्हें खाता मीट्रिक्स फ़ील्ड्स क्वेरी के लिए लौटा सकते हैं:

• आईडी - खाता आईडी

• से - प्रारंभ समय

• तक - समाप्त समय

• ग्रैन्युलैरिटी - बकेट आकार

• साइट्स - प्रत्येक साइट के लिए लौटाए जाने वाला डेटा (नेस्टेड क्वेरी और फ़ील्ड्स के साथ एरे)

• टाइमसीरीज - डेटा के लिए समय फ्रेम, और बकेट्स और डेटा के बीच संबंध को परिभाषित करता है (नेस्टेड क्वेरी और फ़ील्ड्स के साथ एरे)

खाता मीट्रिक्स आईडी

आईडी फ़ील्ड विशिष्ट खाता आंतरिक आईडी दिखाता है।

यह खाता आईडी काटो प्रबंधन एप्लिकेशन में नहीं दिखाया गया है, बल्कि यह कटो प्रबंधन एप्लिकेशन के लिए URL में संख्या है। उदाहरण के लिए, निम्नलिखित यूआरएल के लिए खाता आईडी 26 है: https://cc2.catonetworks.com/#!/26/topology।

खाता मीट्रिक्स से

से फ़ील्ड क्वेरी डेटा के लिए प्रारंभिक समय दिखाता है और इसे समय सीमा तर्क में परिभाषित किया जाता है।

खाता मीट्रिक्स तक

तक फ़ील्ड क्वेरी डेटा के लिए समाप्त समय दिखाता है और इसे समय सीमा तर्क में परिभाषित किया जाता है।

खाता मीट्रिक्स ग्रैन्युलैरिटी

ग्रैन्युलैरिटी फ़ील्ड एकल मीट्रिक बकेट के लिए सेकंड में अवधि दिखाता है। बकेटों की संख्या टाइमसीरीज > बकेट तर्क में परिभाषित की गई है।

ग्रैन्युलैरिटी निम्नलिखित सूत्र के अनुसार गणना की जाती है: समय सीमा/बकेट। उदाहरण के लिए, यदि क्वेरी पाँच मिनट का डेटा (समय सीमा) लौटा रही है 60 बकेट के साथ, तो ग्रैन्युलैरिटी (बकेट आकार) 5 सेकंड (300 सेकंड / 60) है।

किसी बकेट के लिए न्यूनतम ग्रैन्युलैरिटी 5 सेकंड है। जब बकेट ग्रैन्युलैरिटी 5 सेकंड से कम होती है, तो यह संभव है कि उस बकेट के लिए कोई डेटा नहीं लौटाया जाए।

ग्रैन्युलैरिटी फ़ील्ड के बारे में अधिक जानकारी के लिए, देखें खाता मीट्रिक्स > ग्रैन्युलैरिटी के साथ कार्य करना।

खाता मीट्रिक्स साइट्स

साइट्स फ़ील्ड खाता में एक या अधिक साइटों से संबंधित डेटा शामिल करता है। आप अपने उपयोगकर्ता आईडी के साथ VPN उपयोगकर्ताओं के लिए डेटा निर्दिष्ट भी कर सकते हैं।

खाता मीट्रिक्स के लिए साइट्स फ़ील्ड के बारे में अधिक जानकारी के लिए, देखें काटो एपीआई - खाता मीट्रिक्स > साइट्स।

खाता मीट्रिक्स टाइमसीरीज

क्वेरी में निर्दिष्ट समय-सीमा (बकेट) के अनुसार खाता के लिए मीट्रिक दिखाता है, और इसमें ऐतिहासिक सांख्यिकी और मीट्रिक शामिल हैं। यह डेटा काटो प्रबंधन अनुप्रयोग में साइट कनेक्टिविटी विंडो के समान है प्रत्येक साइट के लिए।

खाता मीट्रिक्स के लिए टाइमसीरीज फ़ील्ड के बारे में अधिक जानकारी के लिए, देखें काटो एपीआई - खाता मीट्रिक्स > टाइमसीरीज।

खाता मीट्रिक्स के लिए तर्क

ये वे तर्क हैं जिन्हें आप पास कर सकते हैं और डेटा को परिभाषित कर सकते हैं जिसे क्वेरी द्वारा लौटाया जाता है:

• accountID - खाता आईडी

• आईडी - खाता आईडी (पुराना तर्क)

• समय सीमा - क्वेरी के प्रारंभ और समाप्ति समय

• ग्रुप इंटरफेस - लिंक के लिए एकल लिंक में विश्लेषण जोड़ें (बूलियन मान true के लिए)

• ग्रुप डिवाइसेस - एकल साइट के साथ कई साइटों और एकल सॉकेट के लिए, विश्लेषण को एकल सॉकेट में जोड़ें (बूलियन मान true के लिए)

खाता मीट्रिक्स खाता आईडी तर्क

क्वेरी के लिए लौटाए गए डेटा के लिए खाता आईडी दर्ज करें। यह तर्क अनिवार्य है।

यह खाता आईडी काटो प्रबंधन एप्लिकेशन में नहीं दिखाया गया है, बल्कि यह कटो प्रबंधन एप्लिकेशन के लिए URL में संख्या है। उदाहरण के लिए, निम्नलिखित यूआरएल के लिए खाता आईडी 26 है: https://cc2.catonetworks.com/#!/26/topology।

खाता मीट्रिक्स टाइमफ्रेम तर्क

क्वेरी के लिए लौटाए गए डेटा के लिए समय सीमा दर्ज करें। तर्क प्रारूप <प्रकार>.<समय मान> में है. यह तर्क अनिवार्य है।

समय सीमा को परिभाषित करने के लिए ये समर्थित विकल्प हैं:

• पिछला.<समय अवधि> - पिछला प्रकार के लिए <समय अवधि=""> मान ISO-8601 के अनुसार है और पिछले विशिष्ट समयों के लिए डेटा लौटाता है। ट्रैफ़िक की पुष्टि करना और इसे घटना में प्राप्त डेटा के साथ हस्ताक्षर के संदर्भ से सहसंबंधित करके वास्तविक सकारात्मक या वास्तविक नकारात्मक के रूप में वर्गीकृत करना।

  • समय सीमा = पिछला.PT5M पिछले 5 मिनट दिखाता है

  • समय सीमा = पिछला.PT2H पिछले 2 घंटे दिखाता है

  • समय सीमा = पिछला.P1D पिछले 1 दिन दिखाता है

  • समय सीमा = पिछला.P3M पिछले 3 महीने दिखाता है

  • समय सीमा = पिछला.P1Y पिछले 1 साल दिखाता है

• utc.<छोटी-समय-सीमा-निर्दिष्टक> - समय सीमा में प्रारंभ और समाप्ति तिथि को शामिल करते हुए प्रारूप YY-MM-DD/hh:mm:ss में होता है जो निर्दिष्ट समय क्षेत्र के अनुसार होता है। इस तर्क के लिए आपको सभी तिथि और समय मान दर्ज करने होंगे। उदाहरण के लिए:

  • टाइमफ्रेम = utc.2020-02-{11/04:50:00--21/04:50:00} 11 फरवरी, 2020 सुबह 4:50:00 बजे से 21 फरवरी, 2020 सुबह 4:50:00 बजे तक के 10 दिन के विश्लेषण डेटा को दिखाता है

  • टाइमफ्रेम = utc.2020-02-11/{04:50:15--16:50:15} 11 फरवरी, 2020 को सुबह 4:50:15 बजे से 16:50:15 बजे तक के 12 घंटे के विश्लेषण डेटा को दिखाता है

  • टाइमफ्रेम = utc.2020-{02-11/04:50:00--04-11/04:50:00} 11 फरवरी, 2020 सुबह 4:50:00 बजे से 11 अप्रैल 4:50:00 बजे तक के 2 महीने के विश्लेषण डेटा को दिखाता है

  • टाइमफ्रेम = utc.{2019-10-01/04:50:00--2020-02-01/04:50:00} 1 अक्टूबर, 2019 सुबह 4:50:00 बजे से 11 फरवरी, 2020 सुबह 4:50:00 बजे तक के 4 महीने के विश्लेषण डेटा को दिखाता है

    यह प्रारूप आपको एक से अधिक कैलेंडर वर्ष को शामिल करने वाली समय सीमा को कॉन्फ़िगर करने देता है

टाइमफ्रेम तर्क और ग्रैन्युलैरिटी फ़ील्ड के बारे में अधिक जानकारी के लिए, देखें खाता मीट्रिक्स के साथ कार्य करना > ग्रैन्युलैरिटी।

खाता मीट्रिक्स ग्रुप इंटरफेस तर्क

जब बूलियन तर्क ग्रुप इंटरफेस true पर सेट होता है, तो सभी इंटरफेस के डेटा का एकल इंटरफेस में संग्रहशीलता की जाती है।

खाता मीट्रिक्स ग्रुप डिवाइसेस तर्क

जब बूलियन तर्क ग्रुप डिवाइसेस true पर सेट होता है, तो सभी सॉकेट्स (आमतौर पर उच्च उपलब्धता में दो) का विश्लेषण एक परिणाम के रूप में संग्रहित किया जाता है। संग्रहीत सॉकेट्स के लिए सर्वोत्तम परिणामों के लिए, हम अनुशंसा करते हैं कि लिंक पर नेटवर्क और कार्यक्षमता में लगातार नाम और कार्यक्षमता (उदाहरण के लिए गंतव्य) हों।

नोट: इस तर्क को कई साइटों की क्वेरी के लिए अनिवार्य किया जाता है और ग्रुप डिवाइसेस के लिए केवल मान्य मान true है।