تعتمد واجهة برمجة التطبيقات appStats على شاشة تحليلات التطبيق وتوفر بيانات شبكة مجمعة على مدى فترة زمنية حسب المصدر والوجهة والتطبيق وما إلى ذلك.
كل استعلام يحسب التجميع عبر مقاييس مختلفة (عدد البايتات المرفوعة، البايتات المحملة، عدد التدفقات، إلخ...) باستخدام دالة تجميع معينة (المجموع، الحد الأقصى، المتوسط، إلخ...) وأبعاد مختلفة (اسم الموقع، المستخدم، التطبيق، إلخ...)
أمثلة على استخدام استعلام appStats:
-
حساب مجموع/متوسط/أقصى عرض نطاق لموقع محدد
-
الحد الأقصى لعدد التدفقات المتولدة إلى وجهة معينة
-
أفضل 10 تطبيقات مستخدمة بواسطة مضيف معين
هذه هي الحجج التي يمكنك تمريرها وتحديد البيانات التي يتم إرجاعها بواسطة الاستعلام (جميع الحقول إلزامية):
أدخل معرّف حساب واحد أو أكثر للبيانات التي يُرجعها الاستعلام.
لا يعرض معرّف الحساب هذا في تطبيق إدارة Cato، بدلاً من ذلك فهو الرقم في الرابط لـتطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 للرابط التالي: https://cc.catonetworks.com/#!/26/topology.
تسمح لك حجة عوامل التصفية بتحديد البيانات المحددة التي يتم تضمينها في الاستعلام. هذه هي الحجج التي يمكنك تحديدها:
-
اسم الحقل - يحدد نوع الحقل الذي تريد تصفيته (لمزيد من المعلومات، انظر أدناه حقول appStats)
-
المشغل - يحدد كيفية تفعيل القيم لتصفية البيانات (لمزيد من المعلومات، انظر أدناه عامل التشغيل لـ appStats)
-
القيم - تحدد قيمة التصفية المستخدمة مع المشغّل
الصيغة التالية لـ الفلاتر مثال لاستعلام يتم تصفيته لإظهار بيانات لتطبيق معين:
"filters": [
{
"fieldName": "application",
"operator": "is",
"values": [
"Slack"
]
}
]
استخدم حجة الأبعاد لتجميع الحقول التي تحتوي على نفس القيم في صفوف ملخصة.
المثال التالي يجمع الحقول حسب أسماء المواقع:
"dimensions": [
{
"fieldName": "site_name"
}
]
تسمح لك حجة المقاييس بتحديد الحقول التي تريد أن يرجعها الاستعلام ونوع تجميعها. هذه هي الحجج التي يمكنك تحديدها:
-
اسم الحقل - يحدد نوع الحقل الذي تريد تصفيته (لمزيد من المعلومات، انظر أدناه حقول appStats)
-
نوع التجميع - يحدد نوع التجميع (لمزيد من المعلومات، انظر أدناه تجميع appStats)
يوضح المثال التالي صيغة المقاييس لاستعلام يقيس ملخص التدفقات التي تم إنشاؤها لتطبيق Slack:
"filters": [
{
"fieldName": "application",
"operator": "is",
"values": [
"Slack"
]
}
]
"measures": [
{
"fieldName": "flows_created",
"aggType": "sum"
},
]
تحدد حجة الترتيب كيفية ترتيب البيانات.
يظهر المثال التالي صيغة الترتيب لاستعلام يقيس ملخص التدفقات التي تم إنشاؤها لتطبيق Slack. ثم يرتب البيانات بترتيب تنازلي حسب التدفقات التي تم إنشاؤها:
"filters": [
{
"fieldName": "application",
"operator": "is",
"values": [
"Slack"
]
}
]
"measures": [
{
"fieldName": "flows_created",
"aggType": "sum"
},
]
"sort": [
{
"fieldName": "flows_created",
"order": "dec"
},
]
هذا مثال لاستخدام واجهة برمجة تطبيقات الاستعلام appStats لإرجاع مجموع التدفقات التي تم إنشاؤها لتطبيق Slack لكل موقع على مدار فترة زمنية تمتد إلى اليومين الماضيين. يتم ترتيب البيانات بترتيب تنازلي لأفضل خمسة مواقع.
استعلام نموذجي
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
}
مخرج appStats نموذجي
{
"data": {
"appStats": {
"id": "1234",
"records": [
{
"fieldsMap": {
"flows_created": "116660",
"site_name": "Sample Socket"
}
},
{
"fieldsMap": {
"flows_created": "105655",
"site_name": " Sample Socket 2"
}
}
]
}
}
}
هذا وصف للحقول في استعلامات appStats.
|
البند |
الوصف |
|---|---|
|
التطبيق |
اسم التطبيق السحابي |
|
تطبيق جديد |
معرف التطبيق السحابي الجديد |
|
تطبيق مكتشف |
إجمالي عدد التطبيقات المستخدمة |
|
الحركة |
المجموع الكلي للبيانات المرفوعة والمحملة بالبايتات |
|
التحميل |
البيانات المحملة للتطبيقات السحابية |
|
التنزيل |
البيانات المحملة من التطبيقات السحابية |
|
نقاط المخاطر |
درجة مخاطرة التطبيق المخصصة من قبل Cato |
|
مستوى المخاطر |
مستوى المخاطرة للتطبيق |
|
المعتمدة |
التطبيقات السحابية المعتمدة للاستخدام والمدارة من قبل المنظمة |
|
موقع المكتب الرئيسي |
الدولة التي يقع فيها المكتب المسجل للتطبيق |
|
هل هو تطبيق سحابي |
يشير ما إذا كان التطبيق يُعتبر تطبيق سحابي/تطبيق SaaS |
|
الفئة |
فئة التطبيقات السحابية |
|
الوصف |
وصف الفئة |
|
IP |
عنوان IP للمضيف أو عميل SDP |
|
الشبكة الفرعية |
اسم الشبكة الفرعية |
|
النطاق |
SSL SNI، اسم المضيف HTTP، اسم DNS، أو عنوان IP الوجهة |
|
dest_ip |
عنوان IP للخادم (ذو صلة فقط بالاتصالات عبر WAN) |
|
معرّف الموقع المصدر |
معرّف Cato الداخلي الفريد للموقع |
|
اسم الموقع المصدر |
الموقع المصدر أو مستخدم SDP |
|
دولة الموقع |
الدولة التي يقع فيها الموقع |
|
حالة الموقع |
الحالة التي يقع فيها الموقع |
|
معرّف مستخدم VPN |
المعرف الفريد الداخلي لـ Cato لمستخدم SDP |
|
التيارات المُنشئة |
عدد الاتصالات المُنشئة |
|
الموقع الوجهة |
الموقع الوجهة أو معرّف مستخدم SDP (بروتوكول) |
|
هل الموقع الوجهة هو موقع أو VPN |
الموقع الوجهة أو مستخدم SDP |
|
معرّف الموقع الوجهة |
الموقع الوجهة أو معرّف المستخدم SDP (DB) |
|
اسم الموقع الوجهة |
الموقع الوجهة أو اسم مستخدم SDP |
|
اتجاه الحركة |
اتجاه الحركة |
|
device_name |
اسم الحاسوب أو الجهاز |
|
ad_name |
اسم Active Directory |
|
src_ip |
IP للمضيف أو عميل SDP |
|
socket_interface |
اسم واجهة Socket |
|
src_is_site_or_vpn |
حركة المرور هي موقع أو عميل SDP |
لا توجد تعليقات
الرجاء تسجيل الدخول لترك تعليق.