محتويات الدورة

اختبار API / متقدم: دليل ذو إصدار ومراجعة / الدرس 16

تفسير أدلة أداء الواجهات محليا

حساب ملخصات زمن وميزانيات مختلقة دون قياس خدمة أو توليد حركة.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى
في هذه الصفحة

أهداف الدرس

  • تحديد الحمل وحدود الزمن وسياسة الخطأ قبل تفسير القياس.
  • شرح قصور المتوسط والعينات الصغيرة عن إثبات هدف خدمة.

تحديد سؤال الأداء أولا

لا تصبح عبارة «الواجهة سريعة» متطلبا قابلا للاختبار حتى تحدد العملية والحمل وحدود القياس والقبول. افصل المدة التي يراها العميل عن معالجة الخادم وانتظار الطابور. تؤثر الحمولة وشكل البيانات والتزامن والذاكرة المؤقتة والتبعيات في النتيجة. يحتاج البحث والتصدير إلى هدفين مختلفين. يستخدم الدرس عينات مدة مختلقة للحساب فقط ولا يقيس خدمة أو يرسل حركة أو يكتشف سعة أو يوصي بحد زمني عام.

قراءة التوزيع بدلا من متوسط واحد

قد يخفي المتوسط ذيلا بطيئا. يقارن البرنامج متوسط عشر ملاحظات مختلقة ووسيطها ويحسب المئين الخامس والتسعين بقاعدة أقرب رتبة المعلنة. تختلف تعريفات الكميات، والعينة الصغيرة ضعيفة الدقة؛ فالرتبة هنا أكبر ملاحظة فقط. ارفق الوحدة والعدد بكل ملخص. الحساب الصحيح لبيانات خيالية ليس أداء خدمة مقاسا. احسب الطلبات الفاشلة والملغاة والمنتهية وفق السياسة بدلا من حذفها خفية.

python تلخيص ملاحظات زمن مختلقة
from math import ceil
from statistics import mean, median
samples_ms = [10, 11, 12, 12, 13, 13, 14, 15, 20, 180]
ordered = sorted(samples_ms)
p95 = ordered[ceil(0.95 * len(ordered)) - 1]
assert mean(samples_ms) == 30
assert median(samples_ms) == 13
assert p95 == 180
print("mean=30ms median=13ms nearest-rank-p95=180ms n=10")
الناتج المتوقع
mean=30ms median=13ms nearest-rank-p95=180ms n=10

يجري البرنامج الكامل حسابا حتميا لعشر قيم مختلقة بقاعدة أقرب رتبة. لا يقيس مدة تشغيل، ولا يثبت المخرج هدف خدمة حقيقية أو مجال ثقة.

استخدام الميزانية نموذج تخطيط

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

python ميزانية زمن تسلسلية خيالية
allowances_ms = {"routing": 10, "application": 25, "dependency": 40}
fictional_budget_ms = 100
planned_total = sum(allowances_ms.values())
assert planned_total == 75
assert fictional_budget_ms - planned_total == 25
print("planned=75ms unallocated=25ms")
الناتج المتوقع
planned=75ms unallocated=25ms

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

ضبط تفسير القياسات المستقبلية

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

اتخاذ قرارات الانحدار بالدليل

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

الأخطاء الشائعة وإصلاحها

يخفي المتوسط المنخفض مستخدمين بطيئين

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

توصف عينات مختلقة بأنها نتائج قياس

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

زيادة المهلة هي الإصلاح الوحيد

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

اختبر فهمك

1. لماذا يساوي p95 في العينة 180ms لا قيمة قريبة مستوفاة؟

اعرض الحل المشروح

تختار أقرب رتبة ceil(0.95×10)=10 أي أكبر عينة. قد تستوفي مقدرات أخرى بصورة مختلفة. اذكر القاعدة وصغر العينة؛ ولا يحول أي حساب عشر قيم مختلقة إلى تقدير موثوق لذيل خدمة.

2. يستبعد تقرير كل المهلات قبل حساب الزمن. ما المشكلة؟

اعرض الحل المشروح

قد تبدو الطلبات الناجحة سريعة بينما لا يتلقى كثيرون نتيجة. راجع معدل المهلة وسياسة قياس الزمن معا. احفظ النتائج المقيدة أو الفاشلة بصورة مناسبة ولا تدع تحسنا بناء على مجموعة نجاح أضيق.

أهم ما تعلمته

  • تحتاج ادعاءات الأداء حملا وحدود رصد محددة.
  • يرتبط التوزيع والعدد والوحدات والأخطاء معا.
  • يفيد الحساب المختلق للتخطيط ولا يعد قياس خدمة.

المراجع الرسمية