Orbit
Buildlogboeken weergeven
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Het logboek voor de meest recente implementatie bekijken
Open het project in Orbit. Het paneel Latest build op het tabblad Overview toont het logboek van de meest recente implementatie. Als er momenteel een build wordt uitgevoerd, wordt het logboek live gestreamd, regel voor regel, terwijl de build-agent het produceert.
Klik op Full details om de volledige implementatiedetailpagina te openen.
Logboeken voor een specifieke implementatie bekijken
- Open je project in Orbit.
- Open het tabblad Deployments.
- Klik op een implementatie om de detailpagina te openen.
- Het volledige buildlogboek staat op die pagina.
De lijst Recent deployments op het tabblad Overview bevat op elke rij een link View logs die naar dezelfde plaats gaat. Preview-implementaties hebben dezelfde link in de sectie Preview deployments.
Build-fasen
De detailpagina verdeelt de build in benoemde fasen met een duur voor elk:
| Fase | Wat gebeurt er |
|---|---|
| Clone | Je repository ophalen op de geïmplementeerde commit |
| Cache restore | De cache uitpakken node_modules, voor plannen met build cache |
| Install | Je installatieopdracht uitvoeren |
| Cache save | node_modules opnieuw inpakken voor de volgende build |
| Build | Je build-opdracht uitvoeren |
| Upload | De outputmap verpakken en het artefact opslaan |
| Done | Het artefact staat voor het verkeer |
Dit is de snelste manier om te antwoorden op "waarom was die build traag". Een lange Install-fase met een badge Cold build betekent dat de cache is gemist. Een lange Build-fase betekent dat je eigen build langzamer is geworden.
Build-metagegevens
De kaarten boven het logboek tonen de feiten over de implementatie:
| Kaart | Wat het toont |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back of Awaiting approval |
| Commit | De commit die deze implementatie heeft gebuild, met link naar de provider |
| Branch | De git-branch waaruit het afkomstig is |
| Author | Wie de commit heeft gepusht |
| Build time | Totale tijd, met een Fast, Normal of Slow beoordeling op basis van je eigen geschiedenis |
| Artifact | Grootte van de verpakte output, met downloadlink |
| Framework | Het framework dat Orbit heeft gedetecteerd |
| Package manager | npm, yarn of pnpm, gedetecteerd op basis van je lockfile |
| Build cache | Cache hit of Cold build |
| Build host | Welke build-host het heeft uitgevoerd |
| Queue position | Je plaats in de wachtrij, terwijl de implementatie nog in de wachtrij staat |
| Pull request | Het PR-nummer, voor een preview-implementatie |
| Health score | Een score uit 100 met de vermelde aftrekkingen |
Analyse die Orbit over het logboek uitvoert
De detailpagina is niet alleen een tekstdump. Orbit parseert het logboek en toont wat belangrijk is.
- Build timeline met duurtijden per fase.
- Slow build detected wanneer een build aanzienlijk langzamer is dan je eigen mediaan, met het percentage en je typische tijd van de laatste 10 builds.
- TypeScript errors, geëxtraheerd en geteld, wanneer de build is mislukt bij typechecking.
- Build analysis voor Next.js builds: grootten per route, first-load JS, en statische, dynamische en ISR-routeaantallen.
- Bundle regression waarschuwingen wanneer de first-load JS van een route meer dan 20% groeit ten opzichte van de vorige implementatie, of de gedeelde JS-bundle groeit.
- npm audit resultaten rechtstreeks uit de installatie-output geparseerd, samengevat op ernst.
- Security headers audit gescoord uit 60 punten.
- Smoke test resultaten, als je rooktest-paden hebt geconfigureerd.
- Performance budgets overschreden, als je budgetten hebt ingesteld.
- Build optimization advisor, waarin concrete wijzigingen worden vermeld met een geschatte besparing op grootte, gerangschikt op impact.
- Real user metrics, de p75 Core Web Vitals die zijn opgenomen terwijl die implementatie live was.
Welke omgevingsvariabelen de build werkelijk heeft gezien
De detailpagina vermeldt de sleutels van omgevingsvariabelen die bij buildtijd zijn geïnjecteerd, en vergelijkt ze met je huidige configuratie: toegevoegd, gewijzigd, verwijderd, ongewijzigd. Groene sleutels kwamen van een omgevingsspecifieke override, grijze van projectniveau.
Waarden worden nooit opgeslagen en nooit weergegeven. Een sleutel aanwijzen geeft je een SHA-256-vingerafdruk, wat genoeg is om te bevestigen dat twee omgevingen dezelfde waarde hebben zonder deze bloot te leggen.
Dit diff is de snelste manier om te antwoorden op "is mijn wijziging van omgevingsvariabelen werkelijk in de build beland". Als de implementatie ouder is dan de wijziging, zegt Orbit dit met een melding Environment variables updated since this deployment en herinnert je eraan dat de wijziging pas van kracht wordt bij opnieuw implementeren.
Twee implementaties vergelijken
Klik op Compare in een implementatie om het te vergelijken met de vorige: buildtijd, artefactgrootte, cachestatus, framework en het artefactdiff op bestandsniveau. Dit is de snelste route naar "wat is werkelijk veranderd" wanneer een implementatie anders werkt dan de vorige.
Wanneer een build mislukt
De statuskaart verandert in Failed en het logboek toont waar het is gestopt. Boven het logboek voegt Orbit een gecategoriseerde foutsamenvatting toe met een aanbevolen oplossing. Herkende categorieën zijn onvoldoende geheugen, compilerfout, testfout, lint-fout, installatiefouten, netwerkfouten en timeouts, en Orbit matcht specifieke patronen zoals een ontbrekende module, een ERESOLVE peer-afhankelijkheidsconflict, een TypeScript-foutcode, een volledige buildschijf, een package 404 en een verouderde lockfile.
Er is ook een knop Get AI diagnosis, die de laatste 120 regels van het logboek samen met het gedetecteerde framework en de foutcategorie leest en een duidelijke uitleg retourneert.
De AI-diagnose is gelabeld met AI-generated, verify before acting om een reden. Het is erg goed in staat om je naar de juiste regel van het logboek te wijzen, en het is niet gezaghebbend over je codebase. Lees de logregel waarnaar het verwijst voordat je iets wijzigt.
Een mislukte build opnieuw proberen
Klik op de implementatiedetailpagina op Retry build om dezelfde commit opnieuw uit te voeren zonder een nieuwe push. Dit lost voorbijgaande fouten op, zoals een netwerkfout tijdens installatie.
Als je vermoedt een verouderde gecachete afhankelijkheid, gebruik je More retry options, vervolgens Retry with cleared cache, wat de build cache voordat je opnieuw probeert verwijdert.
Volledige begeleiding per fout staat in Problemen met mislukte builds oplossen.
Een lopende build annuleren
Klik op Cancel terwijl een build wordt uitgevoerd.
Het annuleren beëindigt de build machine onmiddellijk en kan niet ongedaan worden gemaakt. De implementatie wordt opgenomen als Cancelled, en de eerder live implementatie blijft verkeer serveren, dus annuleren haalt je site nooit offline. Let op dat het pushen van een nieuwe commit naar dezelfde branch terwijl een build wordt uitgevoerd de in-flight build automatisch annuleert, dus een geannuleerde implementatie gevolgd door een lopende implementatie is normaal.
Het artefact downloaden
Elke succesvolle implementatie bewaart de verpakte output. Klik op Download op de Artifact-kaart om de exacte bundle te halen die is bediend. Er is ook een artefactbrowser om de inhoud te controleren zonder het hele bestand te downloaden.
Hoe lang artefacten worden bewaard, wordt ingesteld in Settings, onder Artifact retention: het aantal succesvolle artefacten dat per omgeving moet worden behouden, van 10 tot 500, standaard 50. Oudere artefacten worden dagelijks verwijderd. Het artefact van de momenteel live implementatie wordt altijd behouden, ongeacht de instelling.
Artefactretentie is wat rollback mogelijk maakt. Als je het te laag instelt, verkort je hoe ver terug je een slechte implementatie kunt terugdraaien zonder opnieuw te bouwen. Als je veel keer per dag implementeert, verhoog het in plaats van het te verlagen.