Analitiche Progetto Orbit

La scheda Analytics è il quadro completo di come si comporta un progetto: quanto tempo richiedono i build, con quale frequenza hanno successo, quanti minuti di build e quanta larghezza di banda del tuo piano il progetto sta utilizzando, e dove va il tempo quando un build è lento.

Dove si trova Analytics

Apri Orbit, fai clic sul progetto e scegli Analytics nel gruppo Observability nella barra delle schede del progetto. La pagina è intitolata Analytics e copre le prestazioni dei build, il traffico e la frequenza di distribuzione per questo progetto.

Due schede adiacenti suddividono gli stessi dati in modo diverso. Build Insights si concentra sui percentili della durata dei build e sul comportamento della cache, e Web Vitals copre le prestazioni degli utenti reali. Vedi Orbit Build Insights e Orbit Web Vitals.

Le Schede Riepilogative

Cinque schede si trovano nella parte superiore:

Utilizzo Questo Mese

Sotto le schede c'è un pannello intitolato Utilizzo questo mese, che mostra il nome del tuo piano e chiarisce che queste cifre sono a livello di account, non per progetto. Vengono visualizzati due indicatori:

• Minuti di build, utilizzati rispetto al tuo piano di assegnazione mensile, con la quota di questo progetto evidenziata separatamente e i minuti che ti rimangono.
• Larghezza di banda (origin), la stessa struttura in gigabyte.

Se superi un'assegnazione, il pannello mostra l'eccedenza e quanto costa: i minuti di build vengono fatturati a US$0.05 al minuto e la larghezza di banda origin a US$0.03 per GB, in aggiunta al tuo piano.

Inoltre proietta in avanti fino alla fine del mese in base al tasso finora, con una stima dell'eccedenza se continui come stai facendo. Quella proiezione è il numero utile, perché ti dice di un problema mentre puoi ancora fare qualcosa al riguardo.

Build Insights

Il blocco Build Insights legge i dati e scrive l'osservazione per te, in linguaggio naturale, piuttosto che lasciarti a individuarla in un grafico. Quello che appare dipende da cosa è vero per il tuo progetto, ad esempio:

• Un'affermazione sul tasso di successo, un elogio per l'affidabilità o un prompt per rivedere i recenti errori.
• Tempo di build in aumento o in diminuzione rispetto alle due settimane precedenti, con entrambe le medie citate.
• Un basso tasso di hit della cache, con il conteggio dei build che hanno utilizzato una cache calda e un suggerimento su come mantenere stabile la chiave della cache tra i commit.
• I build di lunedì sono più lenti, il che solitamente significa che la cache scade durante il fine settimana.
• Il ramo con le prestazioni peggiori per tasso di successo.
• Un'attesa media della coda superiore a 90 secondi, il che significa che i build sono in attesa di un runner.

Tratta questi come suggerimenti, non come verdetti. Ognuno punta a una sezione più in basso nella pagina con i numeri sottostanti.

Frequenza di Distribuzione, Affidabilità e Attività

Tre visualizzazioni coprono il ritmo:

• Frequenza di distribuzione: ultimi 30 giorni mostra le distribuzioni al giorno.
• Affidabilità: ultimi 8 settimane impila i successi rispetto ai fallimenti per settimana, con il trend rispetto alle quattro settimane precedenti.
• Attività di distribuzione: anno scorso è una mappa termica del calendario, ombreggiata per volume e colorata a seconda che le distribuzioni del giorno abbiano avuto successo.

La mappa termica dell'anno è quella da mostrare a qualcuno che chiede quanto sia attivo un progetto. Gli spazi vuoti e i cluster sono visibili istantaneamente.

Prestazioni dei Build

Build performance rappresenta graficamente l'ultima esecuzione di distribuzioni riuscite come barre, con il tempo di build medio e più veloce e il tasso di hit della cache. Passando il mouse sopra una barra si mostra il ramo e il commit, e se quel build ha colpito la cache.

Build time trend riduce ogni settimana al suo P50 e riporta se questa settimana è più veloce o più lenta.

Build time percentiles fornisce P50, P90 e P99. La nota a piè di pagina è la parte importante: un P90 più basso significa build più coerenti. Se il tuo P50 va bene ma il tuo P90 è il triplo, la maggior parte dei build sono veloci e qualcosa occasionalmente va male, il che è un problema diverso dall'essere uniformemente lento.

Efficienza della Cache

Il blocco Cache efficiency confronta direttamente i build freddi rispetto ai build memorizzati in cache: la durata media di ciascuno, il tempo totale risparmiato e il miglioramento della velocità risultante.

Se la media memorizzata in cache è appena migliore della media fredda, la cache viene ripristinata ma non aiuta, solitamente perché il passaggio di installazione non è la parte lenta del tuo build. Se il tasso di hit stesso è basso, la cache viene invalidata troppo spesso; un lockfile che cambia a ogni commit farà questo.

Per-environment build stats divide i build e i cache hit per produzione, staging e anteprima, che è dove scopri che le anteprime stanno facendo la maggior parte dei tuoi minuti di build.

Statistiche Per Ramo e Per Autore

Due tabelle coprono gli ultimi 30 giorni:

• Per-branch build stats: distribuzioni, tasso di successo e tempo di build medio per ramo.
• Per-author deploy stats: lo stesso per la persona che ha eseguito il push.

La tabella per ramo è quella pratica. Un ramo con un basso tasso di successo è solitamente un ramo con un test interrotto o un type-check che tutti hanno imparato a ignorare.

Attesa della Coda e Ora del Giorno

Build queue wait: ultimi 14 giorni misura il gap tra un build in coda e un builder che lo raccoglie. La nota a piè di pagina imposta l'aspettativa: meno di cinque secondi è tipico, e i picchi indicano contesa.

Build time by hour: ultimi 90 giorni è una mappa termica giorno della settimana per ora del giorno in UTC, che mostra quando i tuoi build sono più lenti, con celle che necessitano di almeno due build prima di essere ombreggiate. Combinato con l'attesa della coda, ti dice se un build lento è il tuo build o un momento occupato.

Cause di Errore

Le distribuzioni non riuscite negli ultimi 30 giorni sono classificate per causa principale: errore di compilazione, errore di installazione, errore di test, errore di lint, timeout, memoria insufficiente, errore di rete o sconosciuto. La sezione evidenzia la categoria principale e quale parte dei tuoi errori rappresenta.

Questo è il percorso più veloce da "i nostri build continuano a fallire" a una cosa specifica da correggere. Se due terzi degli errori sono errori di installazione, il problema è la risoluzione delle dipendenze, non il tuo codice. Troubleshooting Failed Builds copre cosa fare con ogni categoria.

Dimensione dell'Artefatto

Artifact size over time tiene traccia di quanto è grande l'output di ogni build, etichettato come in crescita, in diminuzione o stabile, con le dimensioni più vecchie e più recenti.

Un artefatto in costante crescita vale la pena di essere indagato prima che diventi un sito lento. I soliti sospetti sono una directory di immagini che nessuno pota e una dipendenza che ha tirato qualcosa di enorme.

Web Analytics

La sezione in basso mostra Core Web Vitals da visitatori reali negli ultimi 30 giorni, con le principali pagine, paesi, referrer e prestazioni p75 per pagina.

Se non hai ancora aggiunto lo snippet di raccolta, questa sezione è vuota e offre un link per configurarla. Vedi Orbit Web Vitals per lo snippet e cosa significa ogni metrica.

Dove Andare Dopo

• Orbit Build Insights per percentili e dettagli della cache.
• Orbit Spending Cap per mettere un tetto all'eccedenza.
• Orbit Plan Limits per scoprire cosa include il tuo piano.