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

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

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

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

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

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

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

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

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

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

  • खाता आईडी

  • माप

  • फ़िल्टर

  • आयाम

  • क्रम

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

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

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

यह खाता आईडी Cato प्रबंधन अनुप्रयोग में नहीं दिखाया जाता है, बल्कि यह Cato प्रबंधन अनुप्रयोग के लिए URL में नंबर होता है। उदाहरण के लिए, निम्नलिखित URL के लिए खाता आईडी 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": [   
            "स्लैक"
        ]
      }
]
"measures": [
    {
        "fieldName": "flows_created",
        "aggType": "योग"
    },

]

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

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

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

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

]
"sort": [
    {
        "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"
    }
  ],
  "measures": [
    {
      "fieldName": "flows_created",
      "aggType": "sum"
    },
  ],
"filters": [
    {  
        "fieldName": "application",
        "operator": "is",
        "values": [   
            "Slack"
        ]
      }
]
  "sort": [
    {
      "fieldName": "flows_created",
      "order": "desc"
    }
  ],
  "timeFrame": "last.P2D",
  "limit": 5,
  "from": 0
}

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

{
   "data": {
     "appStats": {
       "id": "1234",
       "records": [
         {
           "fieldsMap": {
             "flows_created": "116660",
             "site_name": "Sample Socket"
           }
         },
         {
           "fieldsMap": {
             "flows_created": "105655",
             "site_name": " Sample Socket 2"
           }
         }
       ]
     }
   }
 } 

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

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

आइटम

विवरण

एप्लिकेशन

क्लाउड एप्लिकेशन नाम

नया_एप्लिकेशन

नया क्लाउड एप्लिकेशन पहचानकर्ता

खोजे गए एप्लिकेशन

उपयोग किए गए कुल ऐप्स की संख्या

ट्रैफ़िक

बाइट्स में अपस्ट्रीम और डाउनस्ट्रीम डेटा का कुल योग

अपस्ट्रीम

क्लाउड एप्लिकेशन में अपलोड किया गया डेटा

डाउनस्ट्रीम

क्लाउड एप्लिकेशन से डाउनलोड किया गया डेटा

जोखिम_स्कोर

केटो द्वारा असाइन किया गया एप्लिकेशन जोखिम स्कोर

जोखिम_स्तर

एप्लिकेशन का जोखिम स्तर

स्वीकृत

क्लाउड एप्लिकेशन जो उपयोग के लिए अनुमोदित हैं और संगठन द्वारा प्रबंधित किए जाते हैं

मुख्यालय_स्थान

जिस देश में पंजीकृत एप्लिकेशन मुख्यालय स्थित है

क्या यह क्लाउड एप्लिकेशन है

यह दर्शाता है कि एप्लिकेशन को क्लाउड ऐप/SaaS ऐप के रूप में माना जाता है या नहीं

श्रेणी

क्लाउड एप्लिकेशन श्रेणी

विवरण

श्रेणी का विवरण

IP

होस्ट या SDP क्लाइंट का IP

सबनेट

सबनेट का नाम

डोमेन

SSL SNI, HTTP होस्ट नाम, DNS नाम या गंतव्य IP

dest_ip

सर्वर IP पता (केवल WAN कनेक्शन के लिए प्रासंगिक)

src_site_id

साइट के लिए अद्वितीय आंतरिक Cato ID

src_site_name

स्रोत साइट या SDP उपयोगकर्ता

site_country

साइट जिस देश में स्थित है

site_state

साइट जहाँ स्थित है

vpn_user_id

SDP उपयोगकर्ता के लिए अद्वितीय आंतरिक Cato ID

flows_created

निर्मित कनेक्शनों की संख्या

dest_site

गंतव्य साइट या SDP उपयोगकर्ता ID (प्रोटो)

dest_is_site_or_vpn

गंतव्य साइट या SDP उपयोगकर्ता

dest_site_id

गंतव्य साइट या SDP उपयोगकर्ता ID (DB)

dest_site_name

गंतव्य साइट या SDP उपयोगकर्ता नाम

ट्रैफिक दिशा

ट्रैफिक दिशा

उपकरण_नाम

पीसी या उपकरण का नाम

ad_नाम

सक्रिय निर्देशिका का नाम

src_ip

होस्ट या एसडीपी क्लाइंट के लिए IP

सॉकेट_इंटरफ़ेस

सॉकेट इंटरफ़ेस के लिए नाम

src_is_site_or_vpn

ट्रैफ़िक साइट या एसडीपी क्लाइंट है

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

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

  • योग

  • गिनती

  • गिनती_अलग

  • अलग

  • औसत

  • अधिकतम

  • न्यूनतम

  • कोई भी

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

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

  • है

  • नहीं है

  • में

  • में नहीं

  • मौजूद है

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

  • के बीच

  • के बीच नहीं

  • gt

  • gte

  • lt

  • lte

क्या यह लेख उपयोगी था?

1 में से 0 के लिए उपयोगी रहा

0 टिप्पणियां