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

खाताMetrics का अवलोकन

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

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

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

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

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

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

• साइट्स की कुल संख्या और वीपीएन उपयोगकर्ता
• मेट्रिक्स की संख्या (एपीआई लेबल / टेलीमेट्री)
• बकेट की संख्या

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

• 10 साइट्स
• 140 वीपीएन उपयोगकर्ता
• 5 मेट्रिक्स
• 150 बकेट्स

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

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

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

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

1. समय अवधि - समय अवधि को सेकंड में बदलें
2. बकेट सीमा - 100000 / ((साइट्स + वीपीएन उपयोगकर्ता) * (मेट्रिक्स)) के आधार पर बकेट सीमा की गणना करें
3. न्यूनतम ग्रैन्युलैरिटी = (समय अवधि) / (बकेट सीमा)

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

• 7 दिन = 6,04,800 सेकंड
• 200 बकेट्स = 10000 / (100) * (5)
• 3024 सेकंड न्यूनतम ग्रैन्युलैरिटी = 604800 / 200

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

accountMetrics फ़ील्ड्स के लिए विवरण

ये विवरण हैं जो accountMetrics क्षेत्र प्रश्न के लिए लौटा सकते हैं:

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

accountMetrics आईडी

आईडी फील्ड अद्वितीय खाता आंतरिक आईडी दिखाता है।

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

accountMetrics से

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

accountMetrics को

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

accountMetrics ग्रैनुलैरिटी

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

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

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

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

accountMetrics साइट्स

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

accountMetrics के लिए साइट्स क्षेत्र के बारे में अधिक जानकारी के लिए, देखें Cato API - AccountMetrics > साइट्स।

accountMetrics टाइमसीरीज़

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

accountMetrics के लिए टाइमसीरीज़ क्षेत्र के बारे में अधिक जानकारी के लिए, देखें Cato API - AccountMetrics > टाइमसीरीज़।

accountMetrics के लिए तर्क

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

• accountID - खाता आईडी
• आईडी - खाता आईडी (पारंपरिक तर्क)
• समय अवधि - क्वेरी की शुरूआत और समाप्ति समय
• groupInterfaces - लिंक के लिए विश्लेषण को एक एकल लिंक में मिलाएँ (boolean मान true के लिए)
• groupDevices - कई साइट्स के लिए, और कई Sockets के साथ एक एकल साइट के लिए, विश्लेषण को एक एकल Socket में मिलाएँ (boolean मान true के लिए)

accountMetrics के लिए खाता आईडी तर्क

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

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

accountMetrics समय अवधि तर्क

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

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

• अंतिम.<समय अवधि> - अंतिम प्रकार के लिए <समय अवधि> मान 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 am से 21 फरवरी, 2020 4:50:00 am तक 10 दिन का विश्लेषिकी डेटा दिखाता है
  • समय अवधि = utc.2020-02-11/{04:50:15--16:50:15} 11 फरवरी, 2020 के 4:50:15 am से 16:50:15 pm तक 12 घंटे का विश्लेषिकी डेटा दिखाता है
  • समय अवधि = utc.2020-{02-11/04:50:00--04-11/04:50:00} 11 फरवरी, 2020 4:50:00 am से 11 अप्रैल 4:50:00 am तक 2 महीने का विश्लेषिकी डेटा दिखाता है
  • समय अवधि = utc.{2019-10-01/04:50:00--2020-02-01/04:50:00} 1 अक्टूबर, 2019 4:50:00 am से 11 फरवरी, 2020 4:50:00 am तक 4 महीने का विश्लेषिकी डेटा दिखाता है

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

timeFrame तर्क और Granularity फ़ील्ड के बारे में अधिक विवरण के लिए, accountMetrics > Granularity के साथ काम करना देखें।

accountMetrics groupInterfaces तर्क

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

accountMetrics groupDevices तर्क

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