نوصي بشدة بأن تقوم بمراجعة السياسة الداعمة لواجهة برمجة التطبيقات الخاصة بـ Cato قبل أن تبدأ في استخدام واجهة برمجة تطبيقات Cato.

نظرة عامة على تغذية الأحداث

يساعد استعلام تغذية الأحداث في تحليل الأحداث الناتجة عن الأنشطة المتعلقة بالشبكات والأمان والمقابس، وعملاء Cato والمزيد. تشبه بيانات الحدث التي يُعيدها هذا الاستعلام الصفحة المراقبة > الأحداث في تطبيق إدارة Cato.

لحسابات إعادة البيع، يمكنك إنشاء مفاتيح برمجة تطبيقات منفصلة داخل كل حساب عميل الذي تقوم بالربط بواجهة برمجة التطبيقات الخاصة بـ Cato. للمزيد حول الحد من المعدل واستعلام واجهة برمجة التطبيقات لتغذية الأحداث، انظر فهم الحد من معدل واجهة برمجة تطبيقات Cato.

فهم الأحداث المسترجعة

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

تخزن Cato بيانات الأحداث لآخر سبعة أيام. كل 24 ساعة، يتم حذف البيانات التي تزيد عمرها عن سبعة أيام.

تتعلق هذه الحقول بتقسيم الأحداث إلى صفحات: المؤشر، وعدد المسترجعة. انظر أدناه للحصول على تفسيرات هذه الحقول.

تمكين تغذية الأحداث لحسابك

استخدم نافذة إدارة الوصول إلى واجهة برمجة التطبيقات لتمكين حسابك لإرسال الأحداث إلى خادم واجهة برمجة التطبيقات الخاصة بـ Cato. بعد تمكين تغذية الأحداث، انتظر حوالي 30 دقيقة حتى يجمع خادم واجهة برمجة التطبيقات ما يكفي من الأحداث لإرجاع البيانات للاستعلام.

لتمكين تغذية الأحداث لحسابك:

1. في لوحة التنقل، اختر الإدارة > واجهة برمجة التطبيقات & التكاملات وانقر على علامة التبويب تكامل الأحداث.
2. حدد تمكين التكامل مع الأحداث الخاصة بـ Cato. يبدأ حسابك في إرسال الأحداث إلى خادم واجهة برمجة التطبيقات الخاصة بـ Cato.

تفاصيل حقول تغذية الأحداث

هذه هي التفاصيل التي يمكن لحقول تغذية الأحداث عرضها للاستعلام:

• المؤشر - مجال المؤشر هو معرف فريد لآخر حدث أعاده استعلام واجهة برمجة التطبيقات
• عدد المسترجعة - عدد الأحداث المسترجعة (أقصى عدد 3000 حدث لكل استرجاع)
• حسابات (سجلات حسابات تغذية الأحداث) - بيانات الحدث للحساب (مصفوفة مع استعلامات وحقول متداخلة)

مؤشر تغذية الأحداث

عندما يكون هناك أكثر من 3000 حدث في قائمة انتظار خادم واجهة برمجة التطبيقات، يظهر حقل المؤشر معرفاً يشير إلى بداية تكرار جديد لاسترجاع الأحداث. على سبيل المثال، إذا أعاد الاستعلام 7500 حدثًا، فإن هذه هي النتائج على مدى التكرارات المسترجعة:

• التكرار الأول - عدد المسترجعة = 3000 (الأحداث)، المؤشر = 1234abc
• التكرار الثاني - عدد المسترجعة = 3000 (الأحداث)، المؤشر = 4567def
• التكرار الثالث - عدد المسترجعة = 1500 (الأحداث)، المؤشر = 8901xyz

  يمكنك تجاهل قيمة المؤشر للدورة النهائية

عدد المسترجعة لتغذية الأحداث

يظهر حقل عدد المسترجعة العدد الإجمالي للأحداث في عملية الاسترجاع الحالية. القيمة القصوى لهذا الحقل هي 3000.

حسابات تغذية الأحداث

تعرض حقول الحسابات (سجلات حسابات تغذية الأحداث) معرفات الحساب وبيانات الحدث لهذا الاستعلام. استخدم الوسيط الأحداث سجل الحسابات > سجل الحدث > اسم حقل الحدث لتصفية بيانات الحدث المعروضة للاستعلام. للمزيد حول سجلات الحدث، انظر واجهة برمجة التطبيقات الخاصة بـ Cato - تغذية الأحداث > سجل الحدث.

تغذية الأحداث > السجلات > اسم حقل الحدث

لمزيد من المعلومات حول القيم العددية لاسم حقل الحدث لأنواع الأحداث المختلفة، انظر مرجع واجهة برمجة التطبيقات الخاصة بشبكة Cato GraphQL.

الوسيطات لتغذية الأحداث

هذه هي الوسائط التي يمكنك تمريرها وتحديد البيانات التي يُعيدها الاستعلام:

• معرفات الحسابات - معرفات الحسابات (بالنسبة للحسابات المتعددة، أدخل المعرفات كمصفوفة)
• المرشحات (مدخل تصفية الحقل الحدث) - تصفية بيانات الحدث وسجل التدقيق الذي يتم الاستعلام عنه (مصفوفة مع استعلامات متداخلة)
• المؤشر - عرض الأحداث فقط لدورة استرجاع محددة وفقًا لقيمة المؤشر

الوسيط معرف تغذية الأحداث

أدخل واحد أو أكثر من معرفات حسابات Cato للبيانات التي يُعيدها الاستعلام. هذا الوسيط ضروري.

لا يظهر معرف الحساب هذا في تطبيق إدارة Cato، وبدلاً من ذلك يكون هو الرقم في عنوان URL لتطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 للعنوان URL التالي: https://cc2.catonetworks.com/#!/26/topology.

المرشح الأحداث تغذية الوسيط

يتيح لك الوسيط المرشحات (مدخل تصفية الحقل الحدث) تحديد الأحداث المحددة التي تُدرج في الاستعلام. هذه هي الوسائط التي يمكنك تحديدها:

• اسم الحقل > اسم حقل مرشح تغذية الأحداث - تحديد نوع أو نوع فرعي للحدث من اكتشاف الحدث
• المشغل - تحديد كيفية تفعيل القيم لتصفية بيانات الحدث
• القيم - تحديد قيمة التصفية المستخدمة مع المشغل

تُعد الصيغة التالية للمرشح مثالاً على استعلام تم تصفيته لعرض أنواع الأحداث بقيمة الأمان:

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

تُعد الصيغة التالية للمرشح مثالاً على استعلام تم تصفيته لعرض أنواع الأحداث الفرعية فقط بقيمة جدار الحماية الإنترنت:

"المرشحات": [
{
"اسم الحقل": "نوع الحدث الفرعي",
"المشغل": "هو",
"القيم": ["جدار الحماية الإنترنت"]
}
]

الوسيط مؤشر تغذية الأحداث

الوسيط مؤشر ضروري ويتيح لك تحديد الاستعلام للأحداث لدورة استرجاع محددة. على سبيل المثال، إذا أعاد الاستعلام 10500 حدثًا، فإن هذه هي النتائج على مدى أول ثلاث دورات استرجاع:

• التكرار الأول - عدد المسترجعة = 3000 (الأحداث)، المؤشر = 1234abc
• التكرار الثاني - عدد المسترجعة = 3000 (الأحداث), المؤشر = 4567def
• التكرار الثالث - عدد المسترجعة = 3000 (الأحداث), المؤشر = 8901xyz

لعرض الأحداث فقط في التكرار الثاني، قم بتعيين وسيط المؤشر إلى 4567def.

لاسترجاع كافة الأحداث التي في قائمة الانتظار، قم بتشغيل الاستعلام باستخدام وسيط مؤشر فارغ (المؤشر:"") مع استعلام GraphQL الأولي.