Orbit
Orbit Build Insights ve Delivery Insights
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'in iki insight görünümü vardır: proje başına Build Insights sekmesi "neden yapılarımız yavaş" sorusuna yanıt veren ve hesap genelinde Insights sayfası "ne kadar iyi gönderim yapıyoruz" sorusuna yanıt veren. Bu kılavuz her ikisini ve hangisinin ne zaman kullanılacağını kapsar.
İki Görünümün Bulunduğu Yer
Build Insights proje başınadır. Orbit sekmesini açın, projeyi tıklayın ve proje sekme şeridindeki Observability grubu altında Build Insights seçeneğini seçin.
Insights hesap genelindedir. Orbit sekmesini açın ve üst düzey navigasyondan Insights seçeneğini seçin. Mission control ve Usage seçeneklerinin yanında yer alır.
Build Insights: Özet Kartları
Sekme kendisini yapı süresi yüzdebirlik dilim, önbellek isabet oranı, başarı oranı ve seçili pencereniz üzerindeki eğilim olarak tanımlar. Pencere sayfanın üst kısmında ayarlanabilir.
| Kart | Size ne söyler |
|---|---|
| Toplam yapılar | Kaç yapı çalıştığı, başarılı ve başarısız olarak ayrılmış |
| Başarı oranı | Healthy, OK veya Needs attention olarak derecelendirilir |
| Build duration p50 | Ortanca yapı, altında p95 ve p99 ile |
| Önbellek isabet oranı | İsabetin hataya karşı oranı |
| Önbellek tasarrufu | Önbelleğin size tasarruf ettirdiği hesaplama süresi |
p50 ile p95 ve p99 eşleştirilmesi konunun önemli noktasıdır. 90 saniyelik p50 ile 95 saniyelik p99, iyi davranış gösteren bir yapıdır. 90 saniyelik p50 ile on bir dakikalık p99, ara sıra çok kötü bir şeyin yanlış gittiği anlamına gelir ve ortalama alma bunu tamamen gizlemiş olur.
Pencerenin içinde yapı yoksa, sayfa bunu belirtir ve dağıtımlarınız daha eskiyse daha geniş bir pencere seçmeyi önerir.
Yapı Hacmi ve Süresi Eğilimi
Eğilim grafiği, pencere içinde günlük yapı sayılarını ortalama süresi yer paylaşımı ile gösterir. Bir güne gelince, sayı, başarılı ve başarısız bölünmesini ve ortalamayı gösterir.
İki seriyi birlikte okuyun. Hacim artarken süresi sabit olan, daha fazla gönderim yapan sağlıklı bir ekiptir. Hacim sabit kalırken süresi artan, genellikle bağımlılık büyümesi veya çalışmayı bırakmış bir önbellek yoluyla sessizce çürüyen bir yapıdır.
Çerçeveler ve Paket Yöneticileri
Eğilimin altında iki dökümü oturur:
- Çerçeveye göre, başarılı yapıları Orbit'in algıladığı çerçeveye göre gruplandırır.
- Paket yöneticileri, tüm yapılar arasında.
Tek uygulama projesinde bunlar birer satırdır ve çok ilginç değildir. Monorepo veya birkaç projesi olan bir hesapta, çıkışı nasıl bulacağınız budur: farklı paket yöneticisindeki bir uygulama veya ortalamayı düşüren bir çerçeve.
Çerçeve algılaması, Orbit'in varsayılan yapı ayarlarını da yönlendiren şeydir: bkz. Frameworks Orbit Supports.
En Yavaş Yapılar
Slowest 10 successful builds tablosu en kötü performanslarınızı dal, süre ve kuyruk zamanı ile listelemektedir. Sayfada optimizasyon adayları olarak tanımlanmıştır.
Özellikle Queued sütununa dikkat edin. Sekiz dakika süren ve altı dakikası sırada geçen bir yapı yavaş yapı değildir, meşgul bir yapı ana bilgisayarıdır ve npm ci dosyasını optimize etmek hiçbir yardımcı olmayacaktır. Sekiz dakika süren ve hiçbir kuyruk zamanı olmayan bir yapı gerçekten yavaştır ve saldırıya değerdir.
En yavaş yapının kurulum aşamasına, yapı aşamasından önce saldırın. Kurulum, ılık bir önbelleğin ödül getirdiği yerdir ve genellikle en kolay kazançtır. Configuring Your Build Command and Output Directory söz konusu ayarları kapsar.
Önbellek Tasarrufu
Sekme, yapı önbelleğinin pencere içinde hesaplama süresinde size tasarruf ettirdiği şeyi ifade eder. Bu sayı, önbelleği sağlıklı tutmaya yönelik argümandır.
Önbellek isabet oranı düşükse, olası nedenler şunlardır:
- Her işlemde değişen, her seferinde önbelleği geçersiz kılan bir kilit dosyası.
- İstemli olarak temizlenen ve henüz yeniden ısındırılmamış yapılar.
- Dağıtımlar arasında uzun boşluklar.
Önbelleği temizlemek bunu sıfırlar; hata ayıklamada alışkanlıktan temizlemeden önce bunu hatırlamak değerdir.
Delivery Insights: DORA Ölçümleri
Hesap genelinde Insights sayfası son 30 günü her proje arasında kapsar ve sayıları Elite, High, Medium veya Low performans bandı ve önceki 30 gün ile karşılaştırma olarak DORA ölçümleri olarak çerçeveler.
| Ölçüm | Sayfada tanım |
|---|---|
| Deploy frequency | Ne sıklıkta dağıtım yaparsınız, tüm ortamlar, tüm projeler |
| Lead time (P50) | İşlem sıraya alındı ve dağıtıldı, P95 ile birlikte |
| Change failure rate | Başarısız olan üretim dağıtımları |
| MTTR (median) | Hata ile bir sonraki üretim başarısı arasındaki zaman |
Bu dört bilinçli olarak gerginliktedir. Ayda bir dağıtım yaparak değişim hata oranını mükemmel görünümü yapabilir ve her zaman gönderim yaparak ve şeyleri bozarak dağıtım sıklığını mükemmel yapabilirsiniz. Bu set sadece birlikte okunduğunda anlamlıdır ve önceki 30 güne karşı eğilim mutlak bantta daha önemlidir.
Proje Dökümü
Ölçümlerin altında aynı 30 günü temel alan her projenin bir tablosu vardır: dağıtımlar, başarılar, başarısızlıklar ve ortalama yapı süresi.
Bu, hesabı düşüren projeyi bulmanın en hızlı yoludur: düşük başarı oranı olanı veya ortalama yapısı diğer herkesinkinin birkaç katı olanı. Ayrıntı için bir sonraki adımda onun Build Insights sekmesini açın.
Hiç veri yoksa, sayfa bunu belirtir ve başlamak için bir dala itmek için sizi uyarır.
Hangi Görünümü Açmak İçin
- Bir yapı yavaş. Build Insights, proje alanında. p50'yi p95'e karşı, ardından kuyruk bekleme süresini, ardından en yavaş yapılar tablosunu görün.
- Yapılar başarısız olmaya devam ediyor. Oran için Build Insights, ardından neden için Analytics sekmesinin hata nedeni sınıflandırması: bkz. Orbit Project Analytics.
- Birisi ekibin nasıl teslim ettiğini soruyor. Insights, hesap genelinde. Dört DORA ölçümü ve bunların eğilim okları bu soruyu doğrudan yanıtlar.
- Sonra ne üzerinde çalışacağınızı seçiyorsunuz. Projeyi bulmak için önce Insights, nedenini bulmak için ikinci olarak Build Insights.
Sorun Giderme
Sayfa boş ancak dağıtım yaptığımızı biliyorum. Pencereyi genişletin. Build Insights varsayılan olarak bekleyebileceğinizden daha kısa bir pencereye ayarlanmıştır ve hesap genelinde sayfa 30 güne sabitlenmiştir.
Önbellek isabet oranı sıfır. Önbellek yakın zamanda temizlendi ya da planınız yapı önbelleği içermiyor. Bkz. Orbit Plan Limits.
Lead time çok uzun görünüyor. Lead time işlemden canlı olana kadar ölçülür, bu nedenle ilk işleminden haftalar sonra birleştirilen uzun süreli bir dal onu şişirir. Bu bir hata değil gerçek bilgidir: çalışmanın birleştirilmemiş oturduğunu söyler.
MTTR boş. Pencerenin içinde hiçbir üretim hatası olmamıştır, bu nedenle kurtarılacak bir şey yoktur. Bu iyi durumdur.
Sonraki Nereye Gidilir
- Daha tam proje başına resim için Orbit Project Analytics.
- Hangi yapıların başarısız olduğunu bildikten sonra Troubleshooting Failed Builds.
- İşlem ile üretim arasında yer alan kapılar için Orbit Deployment Pipeline.