المقاييس

تمنحك صفحة Metrics (الشريط الجانبي > Metrics) رؤية تحليلية أعمق لاستخدامك لـ API. فهي تعرض التوزيع الإجمالي للنتائج وتقسم حركة المرور حسب مفتاح API أو عنوان IP للعميل أو النطاق المستهدف.

للحصول على بطاقات ملخصة ورسوم بيانية زمنية في الوقت الفعلي (Concurrency، Requests، Bytes، Response Time، Budget)، استخدم صفحة Dashboard Overview.

عوامل التصفية

توجد أداتا تحكم أعلى الصفحة: محدد مفتاح API ومحدد فترة زمنية.

عامل تصفية المفتاح

استخدم القائمة المنسدلة لمفتاح API لقصر الصفحة على مفتاح محدد. تظهر فقط المفاتيح التي تقع ضمن نطاق وصولك: المفاتيح الشخصية، أو مفاتيح المؤسسة التي تديرها، أو المفاتيح المشتركة من خلال الفرق.

محدد الفترة الزمنية

استخدم أزرار الفترة الزمنية للتحكم في النافذة الزمنية:

الزر	النافذة
1M	آخر 1 دقيقة
5M	آخر 5 دقائق
30M	آخر 30 دقيقة
1H	آخر 1 ساعة
6H	آخر 6 ساعات
1D	آخر 24 ساعة

يتبع كل من المخطط الدائري والجدول أي خيار تحدده.

توزيع النتائج

يعرض المخطط الدائري في الجزء العلوي تفصيل النجاح/الخطأ للفترة المحددة. مرر مؤشر الماوس فوق أي شريحة لمعرفة العدد الدقيق للطلبات والنسبة المئوية. استخدمه لتحديد ما إذا كان الانخفاض المفاجئ في معدل النجاح يتوافق مع فئة نتائج محددة بسرعة.

أنواع النتائج

يُصنف كل طلب API في نتيجة واحدة بالضبط. فقط success تُحسب ضمن حصتك القابلة للفوترة.

النتيجة	الطبقة	المعنى
`success`	غير متاح	قدم الطلب استجابة صالحة. بدون قواعد `validate`، هذا يعني HTTP 200. إذا أرسلت قواعد `validate`، فإن أي استجابة تقبلها قواعدك تُعد نجاحا، بغض النظر عن حالة HTTP.
`application_error`	الهدف	أرجع الهدف HTTP 200، لكن نص الاستجابة احتوى على حقل خطأ.
`application_fail`	الهدف	أرجع الهدف حالة غير 2xx لم تقبلها قواعد `validate` الخاصة بك، أو لم يرجع أي استجابة على الإطلاق.
`client_error`	المتصل	رُفض طلبك قبل أن يغادر FourA: معلمات غير صالحة، أو قيمة proxy تالفة، أو URL يُترجم إلى عنوان IP خاص أو محجوز (حماية SSRF).
`rate_limit`	FourA	رُفض الطلب بسبب حد RPM أو حد التزامن الخاص بك. راجع Rate Limits.
`service_error`	FourA	أرجعت الواجهة الخلفية خطأ 5xx، أو ردت بنص لم نتمكن من تحليله.
`service_fail`	FourA	فشل في الشبكة: انتهاء المهلة، رفض الاتصال، خطأ DNS، انقطاع اتصال العميل.

يخبرك عمود الطبقة بالمسؤول: target تعني الموقع الذي اتصلت به، وcaller تعني أن طلبك كان سيئا، وFourA تعني أننا لم نتمكن من معالجته.

إذا كنت تستخدم validate.status.accept للسماح برموز معينة غير 200 (على سبيل المثال [200, 403])، فإن هذه الاستجابات تعود كـ success بدلا من application_fail. يتبع التصنيف قرار المحرك بناء على قواعدك، وليس رمز HTTP الأولي.

للحصول على التصنيف الكامل وكيفية تعيينه للفوترة، راجع Request Outcomes.

جدول الاستخدام متعدد العروض

أسفل المخطط الدائري المجوف، يعرض جدول الاستخدام تفاصيل حركة المرور الخاصة بك عبر ثلاث علامات تبويب لعرض البيانات:

علامة التبويب	تجميع البيانات حسب
مفتاح API	كل مفتاح من مفاتيح API الخاصة بك
عنوان IP للعميل	عناوين IP المصدر التي تجري الطلبات
النطاق	النطاقات المستهدفة في طلباتك

تدعم كل علامة تبويب شرائح نطاق على الجانب الأيمن لتغيير الأعمدة المعروضة:

النطاق	ما يعرضه
النطاق الترددي	عدد الطلبات، البايتات الواردة، والبايتات الصادرة
وقت الاستجابة	عدد الطلبات، والحد الأدنى، والمتوسط، والحد الأقصى لوقت الاستجابة
التزامن	عدد الطلبات بالإضافة إلى عدد الطلبات المتزامنة (في عرض مفتاح API فقط)
النتائج	عدد الطلبات بالإضافة إلى تفصيل لكل نتيجة
الميزانية	عدد الطلبات والأرصدة المستهلكة، مفصلة حسب المنتج (Single، و Proxy، و Browser)

يقرأ نطاق الميزانية مقياس credits الذي تكتبه API في كل طلب (راجع Response Headers). المجاميع هي الإنفاق المقاس الخام، بينما تحسب الفوترة نتيجة success فقط ضمن خطتك.

انقر فوق رأس العمود للفرز حسب ذلك العمود. تستمر حالة الفرز لكل جدول عبر عمليات تحميل الصفحة. اضغط على Ctrl أو Cmd وانقر على رأس العمود لإعادة التعيين.