مِخبارMIKHBAR
الويب

GitHub يضيف تفاصيل مراحل مراجعة الطلبات إلى API مقاييس الاستخدام

أعلنت GitHub عن تحديث لواجهة برمجة التطبيقات الخاصة بمقاييس استخدام Copilot على مستوى المستودعات، تتيح للفرق تحليل الوقت المستغرق في مراحل مراجعة طلبات الدمج الثلاثة.

GitHub يضيف تفاصيل مراحل مراجعة الطلبات إلى API مقاييس الاستخدام

تحديث جديد في مقاييس استخدام Copilot

أعلنت GitHub عن إضافة ميزة جديدة إلى تقارير مقاييس استخدام Copilot على مستوى المستودعات للمؤسسات والمنظمات. تتيح هذه الميزة للفرق التقنية فهم توزيع الوقت الذي تستغرقه طلبات الدمج (Pull Requests) في كل مرحلة من مراحل المراجعة. بدلاً من الاقتصار على إجمالي الوقت، تقدم التحديثات الآن تفصيلاً دقيقاً يوضح أين يتم إنفاق الوقت خلال دورة حياة الطلب. ويمكن الرجوع إلى GitHub Changelog للاطلاع على التفاصيل الأصلية للمصدر.

تفاصيل المصفوفة الجديدة pull_request_review_times

أضافت GitHub مصفوفة جديدة اسمها pull_request_review_times إلى كل صف في تقارير repos-1-day. تتضمن هذه المصفوفة بيانات دقيقة لكل مرحلة من المراحل الثلاث الأساسية: الوقت من لحظة جاهزية الطلب للمراجعة حتى المراجعة الأولى، والوقت بين المراجعة الأولى والنهائية، وأخيراً الوقت من المراجعة النهائية حتى الدمج. توفر البيانات قيمتين لكل مرحلة: الوسيط (Median) ونسبة 90% (P90)، مما يساعد المطورين على فهم الأداء النموذجي مقابل الحالات الشاذة. ويمكن الرجوع إلى Back to changelog للاطلاع على التفاصيل الأصلية للمصدر.

حساب الوقت والمعايير المعتمدة

تُقاس المدد الزمنية بالدقائق وتُسجل في اليوم الذي تم فيه دمج الطلب. تشمل المعايير الجديدة فقط الطلبات التي فتحها شخص واحد وقام شخص آخر على الأقل بمراجعتها. يتم تجاهل المراجعات التي يقوم بها الروبوتات أو Copilot أو المؤلف نفسه في حساب هذه المدد. لذلك، قد تكون قيمة total_merged في المصفوفة الجديدة أقل من القيمة الموجودة في حقل pull_requests التقليدي، لأن الأخير يشمل الطلبات المدمجة دون أي مراجعة بشرية.

فوائد تحليل المراحل الثلاث

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

التوفر والوصول إلى البيانات

تتوفر هذه البيانات في تقارير repos-1-day للمؤسسات والمنظمات. لا توجد بيانات تاريخية (Backfill)، حيث تبدأ البيانات بالتراجم من تاريخ الإصدار، مما يعني أن الأيام الأولى قد تكون البيانات فيها محدودة. الطلبات التي أصبحت جاهزة للمراجعة قبل 21 سبتمبر 2026 لن تظهر في هذه المصفوفة، لكنها ستظل محسوبة في إجمالي الطلبات المدمجة. في الأيام التي لا يتم فيها دمج أي طلبات مؤهلة، تكون المصفوفة فارغة [].

متطلبات الصلاحيات والوصول

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

المصادر