Cato للقراءة فقط API - الأحداث

هذا هو المعرِّف الحسابي الذي يتم تشغيل الاستعلام ضده.

يسمح لك وسيط القياسات بتحديد الحقول التي تريد طرح استعلام الأحداث عليها وكيفية تجميع النتائج. لكل حقل تريد تحليله، يجب تحديد ما يلي: 

يوضح المثال التالي صيغة القياسات للاستعلام الذي يعيد مجموع حقول event_count: 

 "قياسات": [
    {"اسم الحقل":"event_count","نوع التجميع":"المجموع"}
]

يسمح لك وسيط الفلاتر بتحديد مرشح ينتج عنه فحص مجموعة فرعية محدودة فقط من الأحداث. لكل مرشح يجب تحديد ما يلي:

هنا مثال على استخدام وسيط الفلاتر لتحديد الأحداث التي تحتوي على نوع حدث الأمن فقط:

"الفلاتر": [
    {
        "اسم الحقل": "نوع الحدث",        
         "المعامل": "هو",
         "القيم": ["الأمن"]
    }
]

استخدم وسيط الأبعاد لتجميع الحقول التي تحمل نفس القيم في صفوف ملخصة.

هنا مثال يجمع الملفات وفقًا لنوع الحدث:

"الأبعاد": [
    {"اسم الحقل": "نوع الحدث"}
]

يحدد وسيط الفرز كيفية ترتيب البيانات المعادة.  هنا مثال على استخدام وسيط الفرز

  'الفرز': [ 
      {'اسم الحقل': 'event_count', 'الترتيب': 'desc'},
      {'اسم الحقل': 'event_type', 'الترتيب': 'asc'}
  ]

يحدد الإطار الزمني للاستعلام.  يتم تحديد ذلك باستخدام التنسيق المحدد بواسطة مواصفة ISO 8601. هنا مثال على كيفية تحديد الإطار الزمني للـ30 يومًا الماضية:

"الإطار الزمني": "last.P30D" 

استعلام الأحداث(
    $accountID: ID!,
    $measures: [EventsMeasure],
    $dimensions: [EventsDimension],
    $filters: [EventsFilter!],
    $sort: [EventsSort!],
    $timeFrame: TimeFrame!,
    $limit: Int,
    $from: Int) {  
    الأحداث(
        accountID: $accountID
        timeFrame: $timeFrame
        measures: $measures
        dimensions: $dimensions
        filters: $filters
        sort: $sort  ) {
        id    
        from
        total
        records(limit: $limit, from: $from) {
            fieldsMap
        }
    }
}

{  
    "معرّف الحساب": "1234",
    "القياسات": [ {
          "اسم الحقل": "نوع_الحدث_الفرعي",
          "نوع التجميع": "عدد_مميز"
          }
    ],
    "الفلاتر": [ {
          "اسم الحقل": "نوع_الحدث",
          "المعامل": "هو", "القيم": ["الأمن"]
          }  
    ],  
    "الإطار الزمني": "last.P1M"
}

{  
    "البيانات": {
        "الأحداث": {
            "معرف": "xxx",
            "من": "2023-01-26T00:00:00Z",
            "إلى": "2023-02-27T00:00:00Z",
            "إجمالي": 1,
            "السجلات": [        
                 { 
                     "خريطة_الحقول": {          
                        "نوع_الحدث_الفرعي": "6"
                        }
                 }
             ]
        }
    }
}