Orbit
نظرات Orbit Build ونظرات Delivery
Orbit has two insight views: a per-project Build Insights tab that answers "why are our builds slow", and an account-wide Insights page that answers "how well are we shipping". This guide covers…
Orbit لديه عرضا insight منفصلان: علامة تبويب Build Insights لكل مشروع تجيب على "لماذا تكون عمليات البناء الخاصة بنا بطيئة"، وصفحة Insights على مستوى الحساب تجيب على "ما مدى جودة شحننا". يغطي هذا الدليل كليهما ومتى تستخدم أيهما.
حيث يوجد العرضان
Build Insights لكل مشروع. افتح Orbit، انقر على المشروع، واختر Build Insights ضمن مجموعة Observability في شريط علامات تبويب المشروع.
Insights على مستوى الحساب. افتح Orbit واختر Insights من التنقل على المستوى الأعلى، بجانب Mission control والاستخدام.
Build Insights: بطاقات الملخص
تصف علامة التبويب نفسها بأنها نسب مئوية لمدة البناء، ومعدل hit للكاش، ومعدل النجاح والاتجاه على نافذتك المحددة، والنافذة قابلة للتعديل في أعلى الصفحة.
| البطاقة | ما تخبرك به |
|---|---|
| إجمالي عمليات البناء | عدد عمليات البناء التي تمت، مقسمة إلى نجحت وفشلت |
| معدل النجاح | مصنف كـ Healthy أو OK أو Needs attention |
| مدة البناء p50 | البناء الوسيط، مع p95 و p99 أدناه |
| معدل hit للكاش | Hits مقابل Misses |
| توفير الكاش | وقت الحوسبة الذي وفره لك الكاش |
الاقتران من p50 مع p95 و p99 هو النقطة. p50 بمدة 90 ثانية مع p99 بمدة 95 ثانية هو بناء حسن التصرف. p50 بمدة 90 ثانية مع p99 بمدة 11 دقيقة يعني أن شيئا ما قد يحدث بشكل خاطئ في بعض الأحيان، والمتوسط كان سيخفيه تماما.
إذا لم تحتوِ النافذة على عمليات بناء، تقول الصفحة ذلك وتقترح اختيار نافذة أكبر إذا كانت عمليات نشرك أقدم.
حجم البناء واتجاه المدة
يرسم مخطط الاتجاه عدد عمليات البناء اليومية عبر النافذة مع overlay لمتوسط المدة. عند تمرير أحد الأيام، يعطيك العدد والانقسام بين النجاحة والفشل، والمتوسط.
اقرأ السلسلتين معا. الحجم مرتفع مع المدة ثابتة هي فريق صحي يشحن أكثر. الحجم ثابت مع المدة تتسلق هو بناء يتعفن بصمت، عادة من خلال نمو الاعتماديات أو كاش توقف عن العمل.
الأطر والمديرين
يوجد أسفل الاتجاه تفصيلان:
- By framework (بالإطار)، حيث يتم تجميع عمليات البناء الناجحة حسب الإطار الذي كشفه Orbit.
- Package managers (مديرا الحزم)، عبر جميع عمليات البناء.
على مشروع تطبيق واحد، يكون هذا صفا واحدا لكل منها وليس مثيرا للاهتمام جدا. على monorepo أو حساب يحتوي على عدة مشاريع، هذا هو كيفية اكتشاف الشذوذ: تطبيق واحد على مدير حزم مختلف، أو إطار يسحب المتوسط.
كشف الإطار هو ما يدفع أيضا إعدادات البناء الافتراضية لـ Orbit: انظر Frameworks Orbit Supports.
أبطأ عمليات البناء
تسرد جدول Slowest 10 successful builds أسوأ الأداء لديك مع فرعها ومدتها ووقت الانتظار، الموصوف على الصفحة بأنها مرشحون للتحسين.
لاحظ عمود Queued على وجه التحديد. بناء استغرق 8 دقائق، 6 منها في الانتظار، ليس بناء بطيء، بل هو مضيف بناء مشغول، ولن تساعدك أي كمية من تحسين npm ci. بناء استغرق 8 دقائق بدون وقت انتظار هو بناء بطيء حقا ويستحق المهاجمة.
هاجم مرحلة التثبيت من أبطأ بناء قبل مرحلة البناء الخاصة به. التثبيت هو حيث يؤتي كاش دافئ ثماره، وعادة ما يكون أسهل فوز. يغطي Configuring Your Build Command and Output Directory الإعدادات المتضمنة.
توفير الكاش
تقدر علامة التبويب ما وفره كاش البناء لك في وقت الحوسبة على النافذة. هذا الرقم هو الحجة للحفاظ على صحة الكاش.
إذا كان معدل hit للكاش منخفضا، فإن الأسباب الشائعة هي:
- ملف lockfile يتغير في كل commit، مما يبطل الكاش في كل مرة.
- عمليات بناء تم حذفها بشكل متعمد ولم تدفأ مرة أخرى.
- فجوات طويلة بين النشرات.
يعيد حذف الكاش تعيين هذا، وهو يستحق التذكر قبل حذفه بالعادة أثناء debugging.
Delivery Insights: مقاييس DORA
تغطي صفحة Insights على مستوى الحساب آخر 30 يوما عبر كل مشروع، وتطبع الأرقام كمقاييس DORA مع نطاق الأداء من Elite أو High أو Medium أو Low، بالإضافة إلى مقارنة مع آخر 30 يوما.
| المقياس | التعريف على الصفحة |
|---|---|
| تكرار النشر | عدد مرات النشر، جميع البيئات، جميع المشاريع |
| وقت الانتقال (P50) | commit إلى النشر، مع P95 بجانبه |
| معدل فشل التغيير | نشرات الإنتاج التي فشلت |
| MTTR (متوسط) | الفشل إلى نجاح الإنتاج التالي |
هذه الأربعة متعارضة بقصد. يمكنك جعل معدل فشل التغيير يبدو مثاليا بالنشر مرة واحدة في الشهر، ويمكنك جعل تكرار النشر يبدو ممتازا بالشحن المستمر وكسر الأشياء. المجموعة لها معنى فقط عند قراءتها معا، والاتجاه مقابل آخر 30 يوم يهم أكثر من النطاق المطلق.
تقسيم المشروع
أسفل المقاييس يوجد جدول بكل مشروع على نفس 30 يوم: النشرات والنجاحات والفشل ومتوسط وقت البناء.
هذه هي أسرع طريقة للعثور على المشروع الذي يسحب الحساب: المشروع ذو معدل النجاح المنخفض، أو المشروع الذي يكون متوسط البناء فيه عدة مرات أكثر من الآخرين. افتح علامة تبويب Build Insights الخاصة به بعد ذلك للحصول على التفاصيل.
إذا لم تكن هناك بيانات على الإطلاق، تقول الصفحة ذلك وتطلب منك الدفع إلى فرع للبدء.
أي عرض تفتح
- بناء بطيء. Build Insights، على المشروع. انظر إلى p50 مقابل p95، ثم انتظار الطابور، ثم جدول أبطأ عمليات البناء.
- عمليات البناء تفشل باستمرار. Build Insights للمعدل، ثم علامة تبويب Analytics للتصنيف حسب سبب الفشل: انظر Orbit Project Analytics.
- شخص ما يسأل عن كيفية تسليم الفريق. Insights، على مستوى الحساب. مقاييس DORA الأربعة مع أسهم الاتجاه تجيب على هذا السؤال مباشرة.
- أنت تختار ما تريد العمل عليه بعد ذلك. Insights أولا للعثور على المشروع، Build Insights ثانيا للعثور على السبب.
استكشاف الأخطاء والإصلاح
الصفحة فارغة لكنني أعرف أننا ننشر. وسع النافذة. يستخدم Build Insights افتراضيا نافذة أقصر مما قد تتوقعه، وتكون صفحة مستوى الحساب محددة بـ 30 يوما.
معدل hit للكاش هو صفر. إما تم حذف الكاش مؤخرا، أو خطتك لا تتضمن caching البناء. انظر Orbit Plan Limits.
وقت الانتقال يبدو ضخما. يتم قياس وقت الانتقال من commit إلى live، لذلك فرع طويل الأمد تم دمجه بعد أسابيع من أول commit يضخمه. هذه معلومات حقيقية وليست bug: إنها تخبرك بأن العمل معلق بدون دمج.
MTTR فارغ. لم يكن هناك فشل في الإنتاج في النافذة، لذا لا يوجد شيء للتعافي منه. هذه هي الحالة الجيدة.
أين تذهب بعد ذلك
- Orbit Project Analytics للحصول على الصورة الكاملة لكل مشروع.
- Troubleshooting Failed Builds بمجرد أن تعرف أي عمليات بناء تفشل.
- Orbit Deployment Pipeline للبوابات التي تقع بين commit والإنتاج.