مخطط سانكي لنتائج طلبات الواجهة البرمجية: من نقاط النهاية إلى الأخطاء
تتبّع طلبات الواجهة البرمجية من نقطة النهاية إلى فئة الحالة إلى سبب كل خطأ. اعرف أي نقاط النهاية تُنتج الإخفاقات ولماذا، ثم استبدل الأعداد التجريبية بسجلاتك.
يتتبع مخطط سانكي لنتائج الواجهة البرمجية الطلبات من نقطة النهاية التي استقبلتها إلى النجاح أو فئة الخطأ، ثم يقسّم كل فئة خطأ حسب السبب. ويشير إلى نقطة النهاية والسبب اللذين يستحقان الإصلاح أولًا.
في المثال مليون طلب عبر أربع نقاط نهاية. ينجح منها 920 ألفًا، ويفشل 60 ألفًا بخطأ من جهة العميل (4xx) و20 ألفًا بخطأ من جهة الخادم (5xx). ويعطي العمود الأخير سبب كل خطأ: إدخال غير صالح ورمز منتهي وعنصر غير موجود وتحديد المعدل من جهة العميل؛ ومهلة وفشل تبعية وعيب برمجي من جهة الخادم.
معدل الخطأ لكل نقطة نهاية رقم واحد، أما مخطط سانكي فيحتفظ بالمسار: لدى الدفع أعلى معدل خطأ خادم في المثال (7 من 150)، ولدى تسجيل الدخول أعلى معدل خطأ عميل (22 من 200). الأرقام مختلقة. استخدم أعدادًا لنافذة واحدة، وبيّن هل تُحسب إعادة المحاولة مرة واحدة أم كل مرة. والفكرة نفسها للتنبيهات بدل الطلبات في /ar/sankey/incident-response.
كيفية قراءة هذا المخطط
- ينجح 920 من 1,000 ألف طلب (92%)؛ و6% أخطاء عميل و2% أخطاء خادم.
- الدفع لديه أعلى معدل خطأ خادم: 7 من 150 (نحو 5%).
- تسجيل الدخول لديه أعلى معدل خطأ عميل: 22 من 200 طلب (11%). وتسبب الرموز المنتهية 20 من أخطاء العميل الـ60.
- نصف أخطاء الخادم (10 من 20) مهلات.
البيانات وراء المخطط
أرقام مختلقة للتوضيح. ليست بيانات عن أي شركة أو فريق أو نظام حقيقي.
| من | إلى | الكمية (ألف طلب) |
|---|---|---|
| البحث | نجاح (2xx) | 370 |
| البحث | خطأ عميل (4xx) | 22 |
| البحث | خطأ خادم (5xx) | 8 |
| الدفع | نجاح (2xx) | 135 |
| الدفع | خطأ عميل (4xx) | 8 |
| الدفع | خطأ خادم (5xx) | 7 |
| تسجيل الدخول | نجاح (2xx) | 175 |
| تسجيل الدخول | خطأ عميل (4xx) | 22 |
| تسجيل الدخول | خطأ خادم (5xx) | 3 |
| الكتالوج | نجاح (2xx) | 240 |
| الكتالوج | خطأ عميل (4xx) | 8 |
| الكتالوج | خطأ خادم (5xx) | 2 |
| خطأ عميل (4xx) | إدخال غير صالح | 25 |
| خطأ عميل (4xx) | رمز منتهي | 20 |
| خطأ عميل (4xx) | غير موجود | 10 |
| خطأ عميل (4xx) | تحديد المعدل | 5 |
| خطأ خادم (5xx) | مهلة | 10 |
| خطأ خادم (5xx) | فشل تبعية | 6 |
| خطأ خادم (5xx) | عيب برمجي | 4 |
البيانات نفسها بصيغة CSV
source,target,value
البحث,نجاح (2xx),370
البحث,خطأ عميل (4xx),22
البحث,خطأ خادم (5xx),8
الدفع,نجاح (2xx),135
الدفع,خطأ عميل (4xx),8
الدفع,خطأ خادم (5xx),7
تسجيل الدخول,نجاح (2xx),175
تسجيل الدخول,خطأ عميل (4xx),22
تسجيل الدخول,خطأ خادم (5xx),3
الكتالوج,نجاح (2xx),240
الكتالوج,خطأ عميل (4xx),8
الكتالوج,خطأ خادم (5xx),2
خطأ عميل (4xx),إدخال غير صالح,25
خطأ عميل (4xx),رمز منتهي,20
خطأ عميل (4xx),غير موجود,10
خطأ عميل (4xx),تحديد المعدل,5
خطأ خادم (5xx),مهلة,10
خطأ خادم (5xx),فشل تبعية,6
خطأ خادم (5xx),عيب برمجي,4كيف تعمل
صدّر نافذة من سجلات الطلبات
خذ ساعة أو يومًا أو أسبوعًا، مع نقطة النهاية ورمز الحالة لكل طلب.
جمّع نقاط النهاية ورموز الحالة
احتفظ بأكثر أربع إلى ست نقاط نهاية ازدحامًا، وجمّع الباقي تحت «أخرى». وجمّع رموز الحالة في فئات.
أضف سبب كل خطأ
استخدم رمز الخطأ أو الرسالة التي تعيدها خدمتك. وجمّع الأسباب في خمس إلى سبع تسميات.
تحقق من التوازن
يجب أن يخرج من كل فئة خطأ بقدر ما دخل إليها. وتنتهي النجاحات عند العمود الثاني.
الأسئلة الشائعة
هل أعرض إعادات التوجيه (3xx)؟
فقط إن كانت مهمة لسؤالك. وإلا فاحسبها نجاحًا أو أخرجها واذكر ذلك في ملاحظة البيانات.
هل أستطيع استخدامه للمراقبة الفورية؟
لا. هو صورة لنافذة ثابتة. أداة المراقبة أفضل للمعدلات الحية؛ والمخطط لتفسير مصدر الإخفاقات.
عدّل مخطط سانكي للواجهة البرمجية
افتح المثال كمخطط خاص بك وأدخل أعداد طلباتك.