المقاييس
توفر لك صفحة المقاييس (الشريط الجانبي > المقاييس) رؤية تحليلية أعمق لاستخدامك لـ API. وهي تعرض التوزيع العام للنتائج وتصنف حركة المرور حسب مفتاح API، أو عنوان IP الخاص بالعميل، أو النطاق المستهدف.
للحصول على بطاقات ملخصة ومخططات زمنية في الوقت الفعلي (Concurrency، وRequests، وBytes، وResponse Time)، استخدم صفحة نظرة عامة على لوحة التحكم.
عوامل التصفية
يوجد عنصرا تحكم أعلى الصفحة: محدد مفتاح API ومحدد الفترة الزمنية.
تصفية المفاتيح
استخدم القائمة المنسدلة لمفتاح API لتحديد نطاق الصفحة لمفتاح معين. تظهر فقط المفاتيح التي تقع ضمن نطاق وصولك: المفاتيح الشخصية، أو مفاتيح المؤسسة التي تديرها، أو المفاتيح المشتركة عبر الفرق.
محدد الفترة الزمنية
استخدم أزرار الفترة الزمنية للتحكم في النافذة الزمنية:
| الزر | النافذة الزمنية |
|---|---|
| 1M | آخر دقيقة واحدة |
| 5M | آخر 5 دقائق |
| 30M | آخر 30 دقيقة |
| 1H | آخر ساعة واحدة |
| 6H | آخر 6 ساعات |
| 1D | آخر 24 ساعة |
يتبع كل من المخطط الدائري والجدول ما تحدده.
توزيع النتائج
يعرض مخطط دائري في الأعلى تفاصيل النجاح/الخطأ للفترة الزمنية المحددة. مرر مؤشر الماوس فوق أي شريحة لرؤية عدد الـ requests الدقيق والنسبة المئوية. استخدمه لتحديد ما إذا كان الانخفاض المفاجئ في معدل النجاح يتوافق مع فئة نتائج معينة بسرعة.
أنواع النتائج
يتم تصنيف كل request لـ API إلى نتيجة واحدة بالضبط. تحتسب نتيجة success فقط ضمن حصتك الخاضعة للرسوم.
| النتيجة | الطبقة | المعنى |
|---|---|---|
success |
n/a | قام الـ request بتقديم response صالح. في حال عدم وجود قواعد validate، فإن هذا يعني HTTP 200. إذا أرسلت قواعد validate، فإن أي response تقبله قواعدك يعتبر نجاحاً، بغض النظر عن حالة HTTP. |
application_error |
target | أرجع الهدف HTTP 200، ولكن جسم الـ response احتوى على حقل خطأ. |
application_fail |
target | أرجع الهدف حالة غير 2xx لم تقبلها قواعد validate الخاصة بك، أو لم يرجع أي response على الإطلاق. |
client_error |
caller | تم رفض الـ request الخاص بك قبل مغادرته لـ FourA: معلمات خاطئة، أو قيمة proxy غير صالحة، أو URL يؤدي إلى IP خاص/محجوز (حماية SSRF). |
rate_limit |
FourA | تم رفض الـ request بواسطة حد RPM أو حد التزامن الخاص بك. راجع حدود المعدل. |
service_error |
FourA | أرجعت الخلفية 5xx، أو ردت بجسم لم نتمكن من تحليله. |
service_fail |
FourA | فشل في الشبكة: انتهاء المهلة، أو رفض الاتصال، أو خطأ في DNS، أو قطع اتصال العميل. |
يخبرك عمود الطبقة بالجهة المسؤولة: تعني target الموقع الذي استدعيته، وتعني caller أن الـ request الخاص بك كان خاطئاً، وتعني FourA أننا لم نتمكن من معالجته.
إذا كنت تستخدم validate.status.accept للسماح برموز معينة غير 200 (على سبيل المثال [200, 403])، فإن هذه الـ responses ستعود كـ success بدلاً من application_fail. يتبع التصنيف قرار المحرك بشأن قواعدك، وليس رمز HTTP الخام.
للاطلاع على التصنيف الكامل وكيفية ارتباطه بالفواتير، راجع نتائج الـ Requests.
جدول الاستخدام متعدد العروض
أسفل المخطط الدائري، يوضح جدول الاستخدام تفاصيل حركة المرور الخاصة بك من خلال ثلاث علامات تبويب للعرض:
| علامة التبويب | تجميع البيانات حسب |
|---|---|
| API Key | كل مفتاح من مفاتيح API الخاصة بك |
| Client IP | عناوين IP المصدر التي تقوم بإرسال الـ requests |
| Domain | النطاقات المستهدفة في الـ requests الخاصة بك |
تدعم كل علامة تبويب أربع شرائح نطاق على اليمين تغير الأعمدة المعروضة:
| النطاق | ما يعرضه |
|---|---|
| Bandwidth | عدد الـ requests، والبايتات الواردة، والبايتات الصادرة |
| Response Time | عدد الـ requests، والحد الأدنى والمتوسط والأقصى لزمن الاستجابة |
| Concurrency | عدد الـ requests بالإضافة إلى أعداد الـ requests المتزامنة (عرض API Key فقط) |
| Outcomes | عدد الـ requests بالإضافة إلى تفصيل لكل نتيجة |
ذو صلة
- نظرة عامة على لوحة التحكم: إحصائيات في الوقت الفعلي ومخططات زمنية
- نتائج الـ Requests: شرح تفصيلي لقيم النتائج السبع
- أخطاء API: كيف تعود الأخطاء عبر الشبكة