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

نظرة عامة على مقاييس الحساب

تساعد استعلامات مقاييس الحساب في تحليل حالة وجودة اتصالات المواقع ومستخدمي SDP إلى سحابة Cato. هذه البيانات مخصصة لحركة المرور داخل نفق DTLS بين الموقع وسحابة Cato.

تُظهر مقاييس الحساب مقاييس تاريخية، إحصاءات، وتحليلات للحساب. تُعيد بيانات مشابهة لنافذة اتصال الموقع في تطبيق إدارة Cato.

لحسابات الموزع، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل تتصل به عبر واجهة برمجة تطبيقات Cato. لمزيد من المعلومات حول التقييد المقدر واستعلام API لمقاييس الحساب، اطلع على فهم التقييد المقدر لواجهة برمجة تطبيقات Cato.

العمل مع دقة حزمة وحدود استعلام API

هناك حد أقصى قدره 100,000 عنصر مُرجَع لكل استعلام API لمقاييس الحساب. إذا وصل الاستعلام إلى هذا الحد، فلن يتم إرجاع أي بيانات إضافية ويتم عرض رسالة خطأ.

تحسب Cato هذا الحد بناءً على ضرب العناصر التالية:

• إجمالي عدد المواقع بالإضافة إلى مستخدمي VPN
• عدد المقاييس (تسميات API/التقارير)
• عدد الحزم

بمعنى آخر، يجب أن يكون مجموع (المواقع + مستخدمي VPN) * (المقاييس) * (الحزم) أقل من 100,000. على سبيل المثال، سيؤدي الاستعلام التالي إلى حدوث خطأ:

• 10 مواقع
• 140 مستخدم VPN
• 5 مقاييس
• 150 حزمة

(10 + 140) * 5 * 150 = 112,500 عنصر في الاستعلام. في هذا المثال، يمكنك تقليل عدد الحزم لتشغيل الاستعلام بنجاح.

لمزيد من المعلومات حول أنواع تسميات API، اطلع على Cato API - AccountMetrics > Timeseries.

حساب الحد الأدنى لدقة الاستعلام

توضح هذه القسم كيفية حساب الحد الأدنى للدقة (حجم الحزمة) بناءً على الإطار الزمني للاستعلام.

1. الإطار الزمني - تحويل الفترة الزمنية إلى ثواني
2. حد الحزم - حساب حد الحزم بناءً على 100000 / ( (المواقع + مستخدمي VPN) * (المقاييس) )
3. الحد الأدنى للدقة = (الإطار الزمني) / (حد الحزم)

على سبيل المثال، تُظهر الصف الأول في الجدول أدناه حد الاستعلام لـ 7 أيام، 100 موقع ومستخدم VPN، مع 5 مقاييس:

• 7 أيام = 604,800 ثانية
• 200 حزمة = 10000 / (100) * (5)
• 3024 ثانية كحد أدنى للدقة = 604800 / 200

الجدول التالي يعرض إعدادات المثال لاستعلام مقاييس الحساب مع الحد الأدنى لدقة الحزمة:

تفاصيل حقول مقاييس الحساب

هذه هي التفاصيل التي يمكن أن تعيدها حقول مقاييس الحساب للاستعلام:

• المعرف - معرف الحساب
• من - وقت البدء
• إلى - وقت الانتهاء
• الدقة - حجم الحزمة
• المواقع - البيانات التي تُعاد لكل موقع (مصفوفة مع استعلامات وحقول متداخلة)
• السلاسل الزمنية - الإطار الزمني للبيانات ويحدد العلاقة بين الحزم والبيانات (مصفوفة مع استعلامات وحقول متداخلة)

معرف مقاييس الحساب

يعرض حقل المعرف معرف الحساب الداخلي الفريد.

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

مقاييس الحساب من

يعرض حقل من وقت البدء لبيانات الاستعلام ويتم تحديده في الحجة timeFrame.

مقاييس الحساب إلى

يعرض حقل إلى وقت الانتهاء لبيانات الاستعلام ويتم تحديده في الحجة timeFrame.

دقة مقاييس الحساب

يعرض حقل الدقة مدة بالثواني لحزمة مقاييس واحدة. يتم تحديد عدد الحزم في السلاسل الزمنية > حجة الحزمة.

يتم حساب الدقة وفقاً للصيغة التالية: timeFrame/buckets. على سبيل المثال، إذا كان الاستعلام يُرجع خمس دقائق من البيانات (timeFrame) مع 60 حزمة، فإن الدقة (حجم الحزمة) هي 5 ثوانٍ (300 ثانية / 60).

الحد الأدنى لدقة الحزمة هو 5 ثوانٍ. عندما تكون دقة الحزمة أقل من 5 ثوانٍ، فيمكن عدم إرجاع أي بيانات لتلك الحزمة.

لمزيد من المعلومات حول حقل الدقة، اطلع على العمل مع مقاييس الحساب > الدقة.

مقاييس الحساب المواقع

يحتوي حقل المواقع على بيانات مرتبطة بموقع أو أكثر في الحساب. يمكنك أيضاً تحديد البيانات لمستخدمي VPN بمعرفاتهم الشخصية.

لمزيد من المعلومات حول حقل المواقع لمقاييس الحساب، اطلع على Cato API - مقاييس الحساب > المواقع.

مقاييس الحساب السلاسل الزمنية

يعرض المقاييس للحساب وفقًا للإطار الزمني المحدد (الحزم) في الاستعلام، ويتضمن إحصاءات تاريخية ومقاييس. هذه البيانات مشابهة للنافذة اتصال الموقع في تطبيق إدارة Cato لكل موقع.

لمزيد من المعلومات حول حقل السلاسل الزمنية لمقاييس الحساب، اطلع على Cato API - مقاييس الحساب > السلاسل الزمنية.

الحجج لمقاييس الحساب

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

• معرف الحساب - معرف الحساب
• المعرف - معرف الحساب (حجة سابقة)
• الإطار الزمني - وقت البدء والانتهاء للاستعلام
• مجموعة الواجهات - دمج التحليلات للروابط في رابط واحد (لقيمة منطقية true)
• مجموعة الأجهزة - بالنسبة لمواقع متعددة، وموقع وحيد مع مآخذ متعددة، دمج التحليلات في مقبس واحد (لقيمة منطقية true)

حجة معرف الحساب لمقاييس الحساب

أدخل معرف الحساب للبيانات التي يُعيدها الاستعلام. هذه الحجة إلزامية.

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

حجة الإطار الزمني لمقاييس الحساب

أدخل الإطار الزمني للبيانات التي يُعيدها الاستعلام. الحجة تكون بصيغة <نوع>.<قيمة الوقت>. هذه الحجة إلزامية.

هذه هي الخيارات المدعومة لتحديد الإطار الزمني:

• last.<المدة الزمنية> - قيمة <المدة الزمنية> لنوع last تكون وفقًا ISO-8601 وتُعيد البيانات للمرات المحددة سابقًا. على سبيل المثال:
  • timeFrame = last.PT5M يعرض آخر 5 دقائق
  • timeFrame = last.PT2H يعرض آخر 2 ساعة
  • timeFrame = last.P1D يعرض اليوم السابق
  • timeFrame = last.P3M يعرض الشهور الثلاثة السابقة
  • timeFrame = last.P1Y يعرض السنة السابقة
• utc.<short-time-frame-spec> - يجمع الإطار الزمني بين تاريخ البداية والنهاية بشكل YY-MM-DD/hh:mm:ss وفقًا للمنطقة الزمنية المحددة. يجب إدخال جميع القيم الخاصة بالتاريخ والوقت لهذه الحجة. على سبيل المثال:
  • timeFrame = utc.2020-02-{11/04:50:00--21/04:50:00} يعرض 10 أيام من بيانات التحليل من 11 فبراير 2020 الساعة 4:50:00 صباحًا إلى 21 فبراير 2020 الساعة 4:50:00 صباحًا
  • timeFrame = utc.2020-02-11/{04:50:15--16:50:15} يعرض 12 ساعة من بيانات التحليل في 11 فبراير 2020، من 4:50:15 صباحًا إلى 16:50:15 مساءً
  • timeFrame = utc.2020-{02-11/04:50:00--04-11/04:50:00} يعرض 2 من بيانات التحليل من فبراير 11, 2020 04:50:00 صباحًا إلى 11 أبريل 04:50:00 صباحًا
  • timeFrame = utc.{2019-10-01/04:50:00--2020-02-01/04:50:00} يعرض 4 أشهر من بيانات التحليل من 1 أكتوبر 2019 04:50:00 صباحًا إلى 11 فبراير 2020 04:50:00 صباحًا

    يتيح لك هذا التنسيق تكوين إطار زمني يتضمن أكثر من عام تقويمي واحد

لمزيد من المعلومات حول حجة الوقت وإطار حقل الدقة، يرجى الاطلاع على التعامل مع مقاييس الحساب > الدقة.

حجة مجموعة الواجهات لمقاييس الحساب

عندما يتم تعيين الحجة المنطقية المجموعة الواجهات إلى true، يتم تجميع البيانات لجميع الواجهات إلى واجهة واحدة.

حجة مجموعة الأجهزة لمقاييس الحساب

عندما يتم تعيين الحجة المنطقية مجموعة الأجهزة إلى true، يتم تجميع التحليلات لجميع المآخذ (عادة اثنين في توافر عالي) كنتيجة واحدة. للحصول على أفضل النتائج للمآخذ المجمعة، نوصي بوجود أسماء ووظائف متسقة (مثل الوجهة) للروابط على كلا المآخذ.