Cato केवल-पढ़ने के लिए API - एप्लिसटेट्स

एप्लिसटेट्स का अवलोकन

एप्लिसटेट्स API एप्लिकेशन एनालिटिक्स स्क्रीन पर आधारित है और स्रोत, गंतव्य, एप्लिकेशन आदि द्वारा समय सीमा में नेटवर्क डेटा एकत्रित करता है।

प्रत्येक प्रश्न पूरे समुच्चय माप (अप बाइट्स, डाउन बाइट्स, प्रवाह संख्या, आदि) के लिए एक निश्चित समुच्चय फ़ंक्शन (योग, अधिकतम, औसत, आदि) और विभिन्न आयामों (साइट_नाम, उपयोगकर्ता, ऐप आदि) पर गणना करता है

एप्लिसटेट्स प्रश्न के उपयोग के उदाहरण:

• एक विशेष साइट की कुल/औसत/अधिकतम बैंडविड्थ की गणना करें

• एक विशिष्ट गंतव्य के लिए उत्पन्न प्रवाह की अधिकतम संख्या

• एक दिए हुए होस्ट द्वारा उपयोग किए गए शीर्ष 10 एप्लिकेशन

एप्लिसटेट्स के आर्गुमेंट्स

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

• खाता आईडी

• माप

• फ़िल्टर

• आयाम

• क्रमबद्ध करें

• समय अवस्थिति

एप्लिसटेट्स खाता आईडी तर्क

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

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

एप्लिसटेट्स फ़िल्टर्स तर्क

फ़िल्टर्स तर्क आपको निर्दिष्ट डेटा को प्रश्न में शामिल करने की अनुमति देता है। ये वे तर्क हैं जिन्हें आप परिभाषित कर सकते हैं:

• फील्डनाम - उस फ़ील्ड के प्रकार को परिभाषित करता है जिसे आप फ़िल्टर करना चाहते हैं (अधिक जानकारी के लिए, नीचे देखें appStats Fields)

• ऑपरेटर - डेटा को फ़िल्टर करने के लिए मानों को कैसे सक्रिय करना है परिभाषित करता है (अधिक जानकारी के लिए नीचे देखें appStats filterOperator)

• मान - फ़िल्टर मान को परिभाषित करता है जो ऑपरेटर के साथ उपयोग किया जाता है

निम्नलिखित फ़िल्टर्स सिंटेक्स एक उदाहरण है जो एक विशेष एप्लिकेशन के लिए डेटा दिखाने के लिए फ़िल्टर किया जाता है:

"फ़िल्टर्स": [
    {  
        "fieldName": "एप्लिकेशन",
        "operator": "है",
        "values": [   
            "स्लैक"
         ]
      }
]

एप्लिसटेट्स आयाम तर्क

आयाम तर्क का उपयोग समान मानों के साथ फ़ील्ड्स को सारांश पंक्तियों में समूहित करने के लिए करें।

निम्नलिखित उदाहरण, साइट नामों के अनुसार फ़ील्ड को समूहित करता है:

"आयाम": [
    {
        "fieldName": "site_name"
    }
]

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

माप तर्क आपको उन फ़ील्ड्स को परिभाषित करने की अनुमति देता है जिन्हें आप प्रश्न के लिए लौटाना चाहते हैं और उनका समुच्चय प्रकार। ये वे तर्क हैं जिन्हें आप परिभाषित कर सकते हैं:

• फील्डनाम - उस फ़ील्ड के प्रकार को परिभाषित करता है जिसे आप फ़िल्टर करना चाहते हैं (अधिक जानकारी के लिए, नीचे देखें appStats Fields)

• aggType - समुच्चय प्रकार को परिभाषित करता है (अधिक जानकारी के लिए, नीचे देखें appStats Aggregation)

निम्नलिखित उदाहरण, स्लैक एप्लिकेशन के लिए बनाए गए प्रवाह का सारांश मापने के लिए माप सिंटेक्स दिखाता है:

"फिल्टर्स": [
    {  
        "fieldName": "एप्लिकेशन",
        "operator": "है",
        "values": [   
            "स्लैक"
         ]
      }
]
"मेजर्स": [
    {
        "fieldName": "flows_created",
        "aggType": "योग"
    },

]

एप्लिसटेट्स क्रम तर्क

क्रम तर्क डेटा को कैसे क्रमित किया जाता है यह परिभाषित करता है।

निम्नलिखित उदाहरण स्लैक एप्लिकेशन के लिए बनाए गए प्रवाह का सारांश मापने के लिए क्रम सिंटेक्स दिखाता है। यह तब प्रवाह बनाए गए के अवरोही क्रम में डेटा को क्रमित करता है:

"फिल्टर्स": [
    {  
        "fieldName": "एप्लिकेशन",
        "operator": "है",
        "values": [   
            "स्लैक"
         ]
      }
]
"मेजर्स": [
    {
        "fieldName": "flows_created",
        "aggType": "योग"
    },

]
"क्रमबद्ध": [
    {
        "fieldName": "flows_created",
        "order": "dec"
    },

]

appStarts समय अवस्थिति तर्क

क्वेरी के समय सीमा को परिभाषित करता है।

"समय अवस्थिति": "last.P2D"

एप्लिसटेट्स प्रश्न का नमूना

यह स्लैक एप्लिकेशन के लिए प्रत्येक साइट पर अंतिम दो दिनों की समय सीमा में बनाए गए प्रवाह के योग को रिटर्न करने के लिए एप्लिसटेट्स API प्रश्न का उपयोग करने का एक उदाहरण है। डेटा शीर्ष पांच साइटों के लिए अवरोही क्रम में क्रमित किया गया है।

उदाहरण प्रश्न

query appStats($accountID: ID!, $measures: [Measure], $dimensions: [Dimension], $filters: [AppStatsFilter!], $sort: [AppStatsSort!], $timeFrame: TimeFrame!, $limit: Int, $from: Int) {
  appStats(
    accountID: $accountID
    timeFrame: $timeFrame
    measures: $measures
    dimensions: $dimensions
    filters: $filters
    sort: $sort
  ) {
    id
    records(limit: $limit, from: $from) {
      fieldsUnitTypes
      fieldsMap
      trends
   
    }
  }
}

चर मान

{
  "accountID": "1234",
  "dimensions": [
    {
      "fieldName": "site_name"
    }
  ],
  "मेजर्स": [
    {
      "fieldName": "flows_created",
      "aggType": "योग"
    },
  ],
"फिल्टर्स": [
    {  
        "fieldName": "एप्लिकेशन",
        "operator": "है",
        "values": [   
            "स्लैक"
         ]
      }
]
  "क्रमबद्ध": [
    {
      "fieldName": "flows_created",
      "order": "asc"
    }
  ],
  "timeFrame": "last.P2D",
  "limit": 5,
  "from": 0
}

एप्लिसटेट्स आउटपुट का नमूना

{
   "data": {
     "appStats": {
       "id": "1234",
       "records": [
         {
           "fieldsMap": {
             "flows_created": "116660",
             "site_name": "सैंपल सॉकेट"
           }
         },
         {
           "fieldsMap": {
             "flows_created": "105655",
             "site_name": "सैंपल सॉकेट 2"
           }
         }
       ]
     }
   }
 }

एप्लिसटेट्स फ़ील्ड्स

यह एप्लिसटेट्स प्रश्नों में फ़ील्ड्स का विवरण है।

ऐपस्टैट्स समेकन

ये ऐपस्टैट्स aggType के लिए मान हैं:

• योग

• गिनती

• गिनती_अलग

• अलग

• औसत

• अधिकतम

• न्यूनतम

• कोई भी

ऐपस्टैट्स फ़िल्टरऑपरेटर

ये ऐपस्टैट्स फ़िल्टरऑपरेटर के लिए मान हैं:

• है

• नहीं है

• में

• में नहीं

• मौजूद है

• मौजूद नहीं है

• के बीच

• के बीच नहीं

• gt

• gte

• lt

• lte