Orbit
Orbit Build Insights en 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 heeft twee inzichtweergaven: een per-project Build Insights tab die antwoordt op "waarom zijn onze builds traag", en een account-brede Insights pagina die antwoordt op "hoe goed verzenden we". Deze gids behandelt beide en wanneer je welke moet gebruiken.
Waar de twee weergaven zich bevinden
Build Insights is per project. Open Orbit, klik het project en kies Build Insights onder de Observability groep in de project tab strip.
Insights is account-breed. Open Orbit en kies Insights van de top-level navigatie, naast Mission control en Usage.
Build Insights: De samenvatting kaarten
De tab beschrijft zichzelf als build duration percentielen, cache hit rate, success rate en trend over je geselecteerde venster, en het venster is aanpasbaar bovenaan de pagina.
| Kaart | Wat het je vertelt |
|---|---|
| Totale builds | Hoeveel builds draaiden, opgesplitst in geslaagde en mislukte |
| Success rate | Beoordeeld als Healthy, OK of Needs attention |
| Build duration p50 | De mediane build, met p95 en p99 eronder |
| Cache hit rate | Hits tegen misses |
| Cache savings | Computetijd die de cache je bespaard heeft |
De combinatie van p50 met p95 en p99 is het punt. Een p50 van 90 seconden met een p99 van 95 seconden is een goed zich gedragende build. Een p50 van 90 seconden met een p99 van elf minuten betekent dat er occasioneel iets ernstig fout gaat, en gemiddelde zou het volledig hebben verborgen.
Als het venster geen builds bevat, zegt de pagina dat en stelt voor een groter venster te kiezen als je deploys ouder zijn.
Build volume en duration trend
De trend grafiek zet dagelijkse build aantallen over het venster uit met een overlay van gemiddelde duration. Door over een dag te hoveren krijg je het aantal, de geslaagde en mislukte split en het gemiddelde.
Lees de twee series samen. Volume omhoog met duration vlak is een gezond team dat meer verzendt. Volume vlak met duration stijgend is een build die stil aan het vervallen is, meestal door afhankelijkheidsgroei of een cache die niet meer werkt.
Frameworks en package managers
Twee breakdowns zitten onder de trend:
- By framework, groepeert succesvolle builds volgens het framework dat Orbit detecteerde.
- Package managers, over alle builds.
Op een single-app project zijn dit elk één rij en niet erg interessant. Op een monorepo of een account met meerdere projecten is dit hoe je de outlier opspottet: één app op een ander package manager, of een framework dat het gemiddelde omlaag trekt.
Framework detectie is wat Orbit's standaard build instellingen aandrijft: zie Frameworks Orbit Supports.
Langzaamste builds
De Slowest 10 successful builds tabel geeft je slechtste performers met hun branch, duration en queue time, beschreven op de pagina als anchor kandidaten voor optimalisatie.
Let op de Queued kolom speciaal. Een build die acht minuten duurde waarvan zes in wachtrij stonden is geen trage build, het is een drukke build host, en geen hoeveelheid optimalisatie van je npm ci helpt. Een build die acht minuten duurde met geen queue time is werkelijk traag en waard om aan te werken.
Ga aan met de install fase van de langzaamste build voordat je de build fase aanvalt. Install is waar een warme cache uitblinkt, en het is meestal de makkelijkste overwinning. Configuring Your Build Command and Output Directory behandelt de betrokken instellingen.
Cache savings
De tab kwantificeert wat de build cache je in computetijd over het venster heeft bespaard. Dat getal is het argument voor het gezond houden van de cache.
Als de cache hit rate laag is, zijn de gebruikelijke oorzaken:
- Een lockfile die op elke commit verandert, waardoor de cache elke keer ongeldig wordt.
- Builds die opzettelijk waren gewist en nog niet weer zijn opgewarmd.
- Lange gaten tussen deploys.
Het wissen van de cache zet dit opnieuw in, wat het waard is om te onthouden voordat je het uit gewoonte wist terwijl je debuggt.
Delivery Insights: DORA-statistieken
De account-brede Insights pagina dekt de afgelopen 30 dagen over elk project, en frameert de getallen als DORA-statistieken met een performance band van Elite, High, Medium of Low, plus een vergelijking tegen de vorige 30 dagen.
| Metriek | Definitie op de pagina |
|---|---|
| Deploy frequency | Hoe vaak je implementeert, alle omgevingen, alle projecten |
| Lead time (P50) | Commit in wachtrij tot geïmplementeerd, met P95 ernaast |
| Change failure rate | Production deploys die mislukt zijn |
| MTTR (median) | Fout tot de volgende production succes |
Deze vier staan opzettelijk in spanning. Je kunt change failure rate perfect laten eruitzien door eenmaal per maand in te zetten, en je kunt deploy frequency excellent laten eruitzien door constant te verzenden en dingen kapot te maken. De set is alleen betekenisvol samen gelezen, en de trend tegen de vorige 30 dagen betekent meer dan de absolute band.
Project breakdown
Onder de statistieken staat een tabel met elk project over dezelfde 30 dagen: deploys, successen, mislukkingen en gemiddelde build tijd.
Dit is de snelste manier om het project te vinden dat de account omlaag trekt: degene met een lage success rate, of degene wiens gemiddelde build meerdere keren die van iedereen anders is. Open volgende zijn Build Insights tab voor het detail.
Als er helemaal geen gegevens zijn, zegt de pagina dat en nodigt je uit om naar een branch te pushen om aan de slag te gaan.
Welke weergave te openen
- Een build is traag. Build Insights, op het project. Kijk naar p50 versus p95, dan queue wait, dan de langzaamste builds tabel.
- Builds blijven mislukken. Build Insights voor de rate, dan de Analytics tab's failure-cause classificatie voor de reden: zie Orbit Project Analytics.
- Iemand vraagt hoe het team levert. Insights, account-breed. De vier DORA-statistieken met hun trend pijlen beantwoorden die vraag direct.
- Je kiest wat je volgende moet doen. Insights eerst om het project te vinden, Build Insights tweede om de oorzaak te vinden.
Probleemoplossing
De pagina is leeg maar ik weet dat we implementeren. Verbreed het venster. Build Insights staat standaard op een korter venster dan je misschien verwacht, en de account-brede pagina is op 30 dagen vastgesteld.
Cache hit rate is nul. Ofwel de cache is onlangs gewist, ofwel je plan omvat geen build caching. Zie Orbit Plan Limits.
Lead time ziet er enorm uit. Lead time wordt gemeten van commit tot live, dus een langdurige branch die weken na haar eerste commit werd samengevoegd, blaast het op. Dat is echte informatie, geen bug: het vertelt je dat werk onsamengevoegd zit.
MTTR is leeg. Er zijn geen production mislukkingen in het venster geweest, dus er is niets om van te herstellen. Dat is het goede geval.
Waar je vervolgens heen gaat
- Orbit Project Analytics voor het voller per-project beeld.
- Troubleshooting Failed Builds zodra je weet welke builds mislukken.
- Orbit Deployment Pipeline voor de gates die tussen een commit en production zitten.