केटो केवल पढ़ें एपीआई - घटनाएँ

यह खाताID है जिसके खिलाफ आप क्वेरी चला रहे हैं।

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

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

 "माप": [
    {"fieldName":"event_count","aggType":"sum"}
]

फिल्टर्स तर्क आपको फ़िल्टर को परिभाषित करने देता है जो केवल घटनाओं के सीमित उपसमुच्चय के परीक्षा के परिणामस्वरूप होता है। प्रत्येक फ़िल्टर के लिए आपको निम्नलिखित परिभाषित करना होगा:

निम्नलिखित उदाहरण सुरक्षा के घटना प्रकार के साथ केवल घटनाओं का चयन करने के लिए फिल्टर्स तर्क को उपयोग में लेता है:

"फिल्टर्स": [
    {
        "fieldName": "event_type",        
         "operator": "is",
         "values": ["Security"]
    }
]

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

यहां एक उदाहरण है जो event_type के अनुसार फ़ाइलों को समूहित करता है:

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

क्रमबद्ध करें तर्क परिभाषित करता है कि लौटाए गए डेटा को कैसे क्रमबद्ध किया जाना है।  यहां क्रमबद्ध करें तर्क का उपयोग का एक उदाहरण है

  'क्रमबद्ध करें': [ 
      {'fieldName': 'event_count', 'order': 'desc'},
      {'fieldName': 'event_type', 'order': 'asc'}
  ]

क्वेरी के समय सीमा को परिभाषित करता है।  यह आईएसओ 8601 विनिर्देश द्वारा परिभाषित प्रारूप का उपयोग करके निर्दिष्ट किया गया है। यहां पिछले 30 दिनों के लिए समय-सीमा निर्दिष्ट करने के तरीके का एक उदाहरण है:

"समय सीमा": "last.P30D" 

प्रश्न घटनाएँ(
    $खाताID: आईडी!,
    $माप: [घटनाएँ माप],
    $आयाम: [घटनाएँ आयाम],
    $फिल्टर्स: [घटनाएँ फिल्टर!],
    $क्रमबद्ध करें: [घटनाएँ क्रमबद्ध करें!],
    $समय सीमा: समय सीमा!,
    $सीमा: पूर्णांक,
    $से: पूर्णांक) {  
    घटनाएँ(
        खाताID: $खाताID
        समय सीमा: $समय सीमा
        माप: $माप
        आयाम: $आयाम
        फिल्टर्स: $फिल्टर्स
        क्रमबद्ध करें: $क्रमबद्ध करें  ) {
        आईडी    
        से
        कुल
        रिकॉर्ड्स(सीमा: $सीमा, से: $से) {
            fieldsMap
        }
    }
}

{  
    "खाताID": "1234",
    "माप": [ {
          "fieldName": "event_sub_type",
          "aggType": "count_distinct"
          }
    ],
    "फिल्टर्स": [ {
          "fieldName": "event_type",
          "operator": "is", "values": ["Security"]
          }  
    ],  
    "समय सीमा": "last.P1M"
}

{  
    "data": {
        "events": {
            "id": "xxx",
            "from": "2023-01-26T00:00:00Z",
            "to": "2023-02-27T00:00:00Z",
            "total": 1,
            "records": [        
                 { 
                     "fieldsMap": {          
                        "event_sub_type": "6"
                        }
                 }
             ]
        }
    }
}