Orbit
Análise de Projetos Orbit
The Analytics tab is the full picture of how a project is behaving: how long builds take, how often they succeed, how much of your plan's build minutes and bandwidth the project is using, and where…
O separador Analytics é a imagem completa de como um projeto está a comportar-se: quanto tempo levam as compilações, com que frequência têm sucesso, quanto dos minutos de compilação e largura de banda do seu plano o projeto está a usar, e onde o tempo está a ser gasto quando uma compilação é lenta.
Onde Analytics Se Localiza
Abra Orbit, clique no projeto, e escolha Analytics no grupo Observability na fita de separadores do projeto. A página tem o título Analytics e cobre desempenho de compilação, tráfego e frequência de implementação para este projeto.
Dois separadores adjacentes dividem os mesmos dados de forma diferente. Build Insights concentra-se em percentis de duração de compilação e comportamento da cache, e Web Vitals cobre o desempenho de utilizadores reais. Veja Orbit Build Insights e Orbit Web Vitals.
Os Cartões de Resumo
Cinco cartões estão dispostos no topo:
| Cartão | O que conta |
|---|---|
| Minutos de compilação | Total de minutos de compilação para este projeto nos últimos seis meses |
| Pedidos de origem | Pedidos que chegaram à sua origem, apenas falhas de cache, nos últimos seis meses |
| Largura de banda de origem | Bytes servidos a partir de origem nos últimos seis meses |
| Taxa de sucesso | Compilações bem-sucedidas em relação ao total de compilações terminadas nos últimos 30 dias |
| Tempo de cache economizado | Tempo de compilação economizado por acertos de cache nas últimas 100 compilações |
Os pedidos de origem e a largura de banda de origem são exatamente isso: apenas origem. Qualquer coisa servida a partir da cache de perímetro não é contada aqui, razão pela qual um site ocupado e bem em cache pode mostrar números surpreendentemente pequenos. Este é o sistema a funcionar como esperado, não uma lacuna na comunicação.
Utilização Este Mês
Abaixo dos cartões encontra-se um painel com o título Usage this month, mostrando o nome do seu plano e deixando claro que estas figuras são em toda a conta, não por projeto. Dois medidores são apresentados:
- Minutos de compilação, utilizados em relação à permissão mensal do seu plano, com a participação deste projeto chamada separadamente e os minutos que lhe restam.
- Largura de banda (origem), a mesma forma em gigabytes.
Se ultrapassar uma permissão, o painel mostra o excesso e quanto custa: os minutos de compilação são cobrados a US$0.05 por minuto e a largura de banda de origem a US$0.03 por GB, além do seu plano.
Também projeta para o final do mês com base na taxa até agora, com um excesso estimado se continuar como está. Essa projeção é o número útil, porque lhe diz sobre um problema enquanto ainda pode fazer algo a respeito.
Um ciclo de compilação descontrolado é a forma clássica de consumir uma permissão. Um webhook de implementação ligado a uma tarefa que se ativa a si mesma na implementação consumirá felizmente minutos a noite toda. Se a projeção saltar abruptamente, verifique o separador Deployments para um padrão repetido antes de assumir que o seu tráfego aumentou. Um limite de gastos lhe dá um ponto de paragem: veja Orbit Spending Cap.
Build Insights
O bloco Build Insights lê os dados e escreve a observação para si, em linguagem simples, em vez de o deixar a detetar num gráfico. O que aparece depende do que é verdadeiro para o seu projeto, por exemplo:
- Uma declaração de taxa de sucesso, elogiando a boa fiabilidade ou um aviso para rever falhas recentes.
- Tempo de compilação para cima ou para baixo em comparação com a quinzena anterior, com ambas as médias citadas.
- Uma taxa de acerto de cache baixa, com a contagem de compilações que utilizaram uma cache aquecida e um incentivo sobre a manutenção da chave de cache estável entre commits.
- Compilações de segunda-feira mais lentas, o que geralmente significa que a cache expira durante o fim de semana.
- O ramo com o pior desempenho por taxa de sucesso.
- Uma espera de fila média superior a 90 segundos, o que significa que as compilações estão à espera de um executor.
Trate estas como pistas, não como vereditos. Cada uma aponta para uma secção mais abaixo na página com os números subjacentes.
Frequência de Implementação, Fiabilidade e Atividade
Três visualizações cobrem cadência:
- Deploy frequency: last 30 days mostra implementações por dia.
- Reliability: last 8 weeks empilha bem-sucedidas contra falhadas por semana, com a tendência em relação às quatro semanas anteriores.
- Deploy activity: past year é um mapa de calor de calendário, sombreado por volume e colorido de acordo com o facto de as implementações do dia terem tido sucesso.
O mapa de calor do ano é o que mostrar a alguém que pergunta como é ativo um projeto. Lacunas e agrupamentos são visíveis instantaneamente.
Desempenho de Compilação
Build performance apresenta graficamente a última execução de implementações bem-sucedidas como barras, com tempo de compilação médio e mais rápido e a taxa de acerto de cache. Ao passar o cursor sobre uma barra mostra o ramo e commit, e se essa compilação acertou na cache.
Build time trend reduz cada semana ao seu P50 e relata se esta semana é mais rápida ou mais lenta.
Build time percentiles dá P50, P90 e P99. A nota de rodapé é a parte importante: um P90 mais baixo significa compilações mais consistentes. Se o seu P50 está bem mas o seu P90 é o triplo, a maioria das compilações é rápida e algo ocasionalmente corre mal, o que é um problema diferente de ser uniformemente lento.
Eficiência de Cache
O bloco Cache efficiency compara compilações frias contra compilações em cache diretamente: a duração média de cada uma, o tempo total economizado, e a melhoria de velocidade resultante.
Se a média em cache é apenas ligeiramente melhor que a média fria, a cache está a ser restaurada mas não está a ajudar, geralmente porque a etapa de instalação não é a parte lenta da sua compilação. Se a taxa de acerto em si é baixa, a cache está a ser invalidada com demasiada frequência; um ficheiro de lockfile que muda em cada commit fará isso.
Per-environment build stats divide compilações e acertos de cache por produção, staging e preview, que é onde descobre que as previews estão a fazer a maioria dos seus minutos de compilação.
Estatísticas Por Ramo e Por Autor
Duas tabelas cobrem os últimos 30 dias:
- Per-branch build stats: implementações, taxa de sucesso e tempo médio de compilação por ramo.
- Per-author deploy stats: o mesmo pelo autor que fez o push.
A tabela por ramo é a prática. Um ramo com uma taxa de sucesso baixa é geralmente um ramo com um teste quebrado ou verificação de tipo que todos aprenderam a ignorar.
Espera de Fila e Hora do Dia
Build queue wait: last 14 days mede o intervalo entre uma compilação ser enfileirada e um construtor a recolher. A nota de rodapé define a expectativa: menos de cinco segundos é típico, e picos indicam contenção.
Build time by hour: last 90 days é um mapa de calor de dia da semana por hora do dia em UTC, mostrando quando as suas compilações são mais lentas, com células que necessitam de pelo menos duas compilações antes de serem sombreadas. Combinado com espera de fila, diz-lhe se uma compilação lenta é a sua compilação ou um momento ocupado.
Causas de Falha
As implementações falhadas nos últimos 30 dias são classificadas por causa raiz: erro de compilação, falha de instalação, falha de teste, erro de lint, timeout, falta de memória, erro de rede ou desconhecido. A secção destaca a categoria superior e quanto das suas falhas representa.
Esta é a rota mais rápida de "as nossas compilações continuam a falhar" para uma coisa específica a corrigir. Se dois terços das falhas são falhas de instalação, o problema é resolução de dependências, não o seu código. Troubleshooting Failed Builds cobre o que fazer com cada categoria.
Tamanho de Artefato
Artifact size over time segue o tamanho da saída de cada compilação, marcado como crescente, decrescente ou estável, com os tamanhos mais antigos e mais recentes.
Um artefato em crescimento constante vale a pena investigar antes de se tornar um site lento. Os suspeitos habituais são um diretório de imagem que ninguém poda e uma dependência que puxou algo enorme.
Análise Web
A secção inferior mostra Core Web Vitals de visitantes reais nos últimos 30 dias, com as principais páginas, países, referenciadores e desempenho p75 por página.
Se ainda não adicionou o snippet de recolha, esta secção está vazia e oferece uma ligação para a configurar. Veja Orbit Web Vitals para o snippet e o que cada métrica significa.
Para Onde Ir a Seguir
- Orbit Build Insights para percentis e detalhe de cache.
- Orbit Spending Cap para colocar um limite no excesso.
- Orbit Plan Limits para o que o seu plano inclui.