Orbit
Analítica de Proyectos 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…
La pestaña Analytics es la imagen completa de cómo se comporta un proyecto: cuánto tiempo toman las compilaciones, con qué frecuencia tienen éxito, cuántos minutos de compilación y ancho de banda del plan del proyecto se están utilizando, y dónde va el tiempo cuando una compilación es lenta.
Dónde vive Analytics
Abre Orbit, haz clic en el proyecto y elige Analytics bajo el grupo Observability en la barra de pestañas del proyecto. La página se titula Analytics y cubre el rendimiento de compilación, tráfico y frecuencia de implementación para este proyecto.
Dos pestañas vecinas dividen los mismos datos de manera diferente. Build Insights se enfoca en percentiles de duración de compilación y comportamiento de caché, y Web Vitals cubre el rendimiento del usuario real. Consulta Orbit Build Insights y Orbit Web Vitals.
Las tarjetas de resumen
Cinco tarjetas se encuentran en la parte superior:
| Tarjeta | Qué cuenta |
|---|---|
| Minutos de compilación | Total de minutos de compilación para este proyecto durante seis meses |
| Solicitudes de origen | Solicitudes que llegaron a tu origen, solo errores de caché, durante seis meses |
| Ancho de banda de origen | Bytes servidos desde el origen durante seis meses |
| Tasa de éxito | Compilaciones exitosas frente al total de compilaciones terminadas en 30 días |
| Tiempo guardado en caché | Tiempo de compilación guardado por aciertos de caché en las últimas 100 compilaciones |
Las solicitudes de origen y el ancho de banda de origen son exactamente eso: solo origen. Nada servido desde la caché de borde se cuenta aquí, lo que es por qué un sitio ocupado y bien almacenado en caché puede mostrar números sorprendentemente pequeños. Ese es el sistema funcionando correctamente, no una brecha de informes.
Uso este mes
Debajo de las tarjetas hay un panel titulado Usage this month, mostrando el nombre de tu plan y dejando claro que estas cifras son a nivel de cuenta, no por proyecto. Se dibujan dos medidores:
- Minutos de compilación, utilizados contra la asignación mensual de tu plan, con la parte de este proyecto destacada por separado y los minutos que te quedan.
- Ancho de banda (origen), la misma forma en gigabytes.
Si superas una asignación, el panel muestra el exceso y lo que cuesta: los minutos de compilación se facturan a US$0.05 por minuto y el ancho de banda de origen a US$0.03 por GB, además de tu plan.
También proyecta hacia adelante hasta el final del mes según la velocidad hasta ahora, con un exceso estimado si continúas como estás. Esa proyección es el número útil, porque te dice sobre un problema mientras todavía puedes hacer algo al respecto.
Un bucle de compilación descontrolado es la forma clásica de quemar una asignación. Un gancho de implementación conectado a un trabajo que él mismo se activa en la implementación consumirá felizmente minutos toda la noche. Si la proyección salta bruscamente, revisa la pestaña Deployments para buscar un patrón repetido antes de asumir que tu tráfico aumentó. Un límite de gasto te da una parada definitiva: consulta Orbit Spending Cap.
Build Insights
El bloque Build Insights lee los datos y escribe la observación para ti, en lenguaje natural, en lugar de dejarte detectarlo en un gráfico. Lo que aparece depende de lo que sea verdad de tu proyecto, por ejemplo:
- Una declaración de tasa de éxito, ya sea elogios por buena confiabilidad o un aviso para revisar fallos recientes.
- Tiempo de compilación arriba o abajo en comparación con la quincena anterior, con ambos promedios citados.
- Una tasa baja de aciertos de caché, con el recuento de compilaciones que utilizaron un caché cálido y un empujón sobre mantener la clave de caché estable entre commits.
- Las compilaciones del lunes siendo más lentas, lo que generalmente significa que el caché expira durante el fin de semana.
- La rama con peor rendimiento por tasa de éxito.
- Un tiempo de espera promedio en cola de más de 90 segundos, lo que significa que las compilaciones están esperando a un ejecutor.
Trata estos como indicios, no como veredictos. Cada uno señala una sección más abajo en la página con los números subyacentes.
Frecuencia de implementación, confiabilidad y actividad
Tres visualizaciones cubren el ritmo:
- Deploy frequency: last 30 days muestra implementaciones por día.
- Reliability: last 8 weeks apila exitosas frente a fallidas por semana, con la tendencia frente a las cuatro semanas anteriores.
- Deploy activity: past year es un mapa de calor de calendario, sombreado por volumen y coloreado según si las implementaciones del día tuvieron éxito.
El mapa de calor del año es el que debes mostrar a alguien que pregunta cuán activo es un proyecto. Los huecos y clusters son visibles al instante.
Rendimiento de compilación
Build performance grafica la última ejecución de implementaciones exitosas como barras, con el tiempo de compilación promedio y más rápido y la tasa de aciertos de caché. Al pasar el mouse sobre una barra se muestra la rama y commit, y si esa compilación golpeó el caché.
Build time trend reduce cada semana a su P50 e informa si esta semana es más rápida o más lenta.
Build time percentiles da P50, P90 y P99. La nota al pie es la parte importante: un P90 más bajo significa compilaciones más consistentes. Si tu P50 está bien pero tu P90 es el triple, la mayoría de las compilaciones son rápidas y algo ocasionalmente sale mal, que es un problema diferente a ser uniformemente lento.
Eficiencia de caché
El bloque Cache efficiency compara compilaciones frías contra compilaciones en caché directamente: la duración promedio de cada una, el tiempo total guardado, y la mejora de velocidad resultante.
Si el promedio en caché apenas es mejor que el promedio frío, el caché se está restaurando pero no está ayudando, generalmente porque el paso de instalación no es la parte lenta de tu compilación. Si la tasa de aciertos en sí es baja, el caché se está invalidando demasiado a menudo; un lockfile que cambia en cada commit hará eso.
Per-environment build stats divide compilaciones y aciertos de caché por producción, staging y vista previa, que es donde descubres que las vistas previas están haciendo la mayoría de tus minutos de compilación.
Estadísticas por rama y por autor
Dos tablas cubren los últimos 30 días:
- Per-branch build stats: implementaciones, tasa de éxito y tiempo de compilación promedio por rama.
- Per-author deploy stats: lo mismo por la persona que hizo push.
La tabla por rama es la práctica. Una rama con una baja tasa de éxito es generalmente una rama con una prueba rota o una verificación de tipo que todos han aprendido a ignorar.
Espera en cola y hora del día
Build queue wait: last 14 days mide la brecha entre una compilación siendo encolada y un compilador recogiéndola. La nota al pie establece la expectativa: menos de cinco segundos es típico, y los picos indican contención.
Build time by hour: last 90 days es un mapa de calor de día de la semana por hora del día en UTC, mostrando cuándo tus compilaciones son más lentas, con celdas que necesitan al menos dos compilaciones antes de ser sombreadas. Combinado con espera en cola, te dice si una compilación lenta es tu compilación o un momento ocupado.
Causas de fallos
Las implementaciones fallidas durante los últimos 30 días se clasifican por causa raíz: error de compilación, fallo de instalación, fallo de prueba, error de lint, timeout, falta de memoria, error de red o desconocido. La sección destaca la categoría principal y cuánto de tus fallos representa.
Esta es la ruta más rápida de "nuestras compilaciones siguen fallando" a una cosa específica a arreglar. Si dos tercios de los fallos son fallos de instalación, el problema es la resolución de dependencias, no tu código. Troubleshooting Failed Builds cubre qué hacer con cada categoría.
Tamaño de artefacto
Artifact size over time rastrea qué tan grande es la salida de cada compilación, etiquetada como creciente, decreciente o estable, con los tamaños más antiguo y más reciente.
Un artefacto que crece constantemente vale la pena investigar antes de que se convierta en un sitio lento. Los culpables habituales son un directorio de imagen que nadie limpia y una dependencia que metió algo enorme.
Web Analytics
La sección inferior muestra Core Web Vitals de visitantes reales durante los últimos 30 días, con páginas principales, países, referencias, y rendimiento p75 por página.
Si aún no has agregado el fragmento de recopilación, esta sección está vacía y ofrece un enlace para configurarlo. Consulta Orbit Web Vitals para el fragmento y lo que significa cada métrica.
A dónde ir a continuación
- Orbit Build Insights para percentiles y detalle de caché.
- Orbit Spending Cap para poner un techo en el exceso.
- Orbit Plan Limits para lo que incluye tu plan.