Orbit
Orbit Build Insights y 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 tiene dos vistas de información: una pestaña Build Insights por proyecto que responde "por qué nuestras compilaciones son lentas", y una página Insights en toda la cuenta que responde "qué tan bien estamos entregando". Esta guía cubre ambas y cuándo usar cuál.
Dónde viven las dos vistas
Build Insights es por proyecto. Abre Orbit, haz clic en el proyecto y elige Build Insights bajo el grupo Observability en la banda de pestañas del proyecto.
Insights es en toda la cuenta. Abre Orbit y elige Insights desde la navegación de nivel superior, junto a Mission control y Usage.
Build Insights: Las tarjetas de resumen
La pestaña se describe a sí misma como percentiles de duración de compilación, tasa de aciertos de caché, tasa de éxito y tendencia en la ventana seleccionada, y la ventana se puede ajustar en la parte superior de la página.
| Tarjeta | Lo que te dice |
|---|---|
| Compilaciones totales | Cuántas compilaciones se ejecutaron, divididas en exitosas y fallidas |
| Tasa de éxito | Calificada como Healthy, OK o Needs attention |
| Duración de compilación p50 | La compilación mediana, con p95 y p99 debajo |
| Tasa de aciertos de caché | Aciertos contra errores |
| Ahorros de caché | Tiempo de cómputo que el caché te ahorró |
El emparejamiento de p50 con p95 y p99 es el punto. Un p50 de 90 segundos con un p99 de 95 segundos es una compilación bien comportada. Un p50 de 90 segundos con un p99 de once minutos significa que algo ocasionalmente sale muy mal, y el promedio lo habría ocultado completamente.
Si la ventana no tiene compilaciones en ella, la página lo indica y sugiere elegir una ventana más grande si tus despliegues son más antiguos.
Tendencia de volumen de compilaciones y duración
El gráfico de tendencia traza recuentos de compilación diarios en toda la ventana con una superposición de duración promedio. Pasar el mouse sobre un día te da el recuento, la división entre exitosas y fallidas, y el promedio.
Lee las dos series juntas. Volumen hacia arriba con duración plana es un equipo saludable que entrega más. Volumen plano con duración hacia arriba es una compilación que se está pudriendo silenciosamente, generalmente a través del crecimiento de dependencias o un caché que dejó de funcionar.
Marcos de trabajo y gestores de paquetes
Dos desgloses se encuentran debajo de la tendencia:
- By framework, agrupando compilaciones exitosas por el marco de trabajo que Orbit detectó.
- Package managers, en todas las compilaciones.
En un proyecto de una sola aplicación estas son una fila cada una y no muy interesantes. En un monorepo o una cuenta con varios proyectos, es cómo detectas el atípico: una aplicación en un gestor de paquetes diferente, o un marco de trabajo que está arrastrando el promedio.
La detección de marco de trabajo es lo que impulsa la configuración de compilación predeterminada de Orbit también: consulta Frameworks Orbit Supports.
Compilaciones más lentas
La tabla Slowest 10 successful builds enumera tus peores rendimientos con su rama, duración y tiempo de espera, descritos en la página como candidatos de anclaje para optimización.
Nota la columna Queued específicamente. Una compilación que tardó ocho minutos de los cuales seis se pasaron en cola no es una compilación lenta, es un host de compilación ocupado, y ninguna cantidad de optimización de tu npm ci ayudará. Una compilación que tardó ocho minutos sin tiempo de espera es genuinamente lenta y vale la pena atacar.
Ataca la fase de instalación de la compilación más lenta antes de su fase de compilación. Install es donde un caché cálido se paga, y generalmente es la victoria más fácil. Configuring Your Build Command and Output Directory cubre los ajustes involucrados.
Ahorros de caché
La pestaña cuantifica lo que el caché de compilación te ha ahorrado en tiempo de cómputo en la ventana. Ese número es el argumento para mantener el caché saludable.
Si la tasa de aciertos de caché es baja, las causas habituales son:
- Un archivo de bloqueo que cambia en cada confirmación, invalidando el caché cada vez.
- Compilaciones que se borraron deliberadamente y aún no se han calentado de nuevo.
- Largos espacios entre despliegues.
Limpiar el caché reinicia esto, lo que vale la pena recordar antes de borrarlo por hábito mientras depuras.
Delivery Insights: Métricas DORA
La página Insights en toda la cuenta cubre los últimos 30 días en todos los proyectos, y encuadra los números como métricas DORA con una banda de rendimiento de Elite, High, Medium o Low, más una comparación contra los 30 días anteriores.
| Métrica | Definición en la página |
|---|---|
| Deploy frequency | Con qué frecuencia despliega, todos los entornos, todos los proyectos |
| Lead time (P50) | Confirmación en cola para desplegada, con P95 junto a ella |
| Change failure rate | Despliegues de producción que fallaron |
| MTTR (median) | Fallo al siguiente éxito de producción |
Estos cuatro están deliberadamente en tensión. Puedes hacer que la tasa de fallo de cambio se vea perfecta desplegando una vez al mes, y puedes hacer que la frecuencia de despliegue se vea excelente entregando constantemente y rompiendo cosas. El conjunto solo tiene sentido leerlo junto, y la tendencia contra los 30 días anteriores importa más que la banda absoluta.
Desglose de proyectos
Debajo de las métricas hay una tabla de cada proyecto en los mismos 30 días: despliegues, éxitos, fallos y tiempo de compilación promedio.
Esta es la forma más rápida de encontrar el proyecto que está arrastrando la cuenta: el que tiene una tasa de éxito baja, o el cuya compilación promedio es varias veces la de todos los demás. Abre su pestaña Build Insights a continuación para más detalles.
Si no hay datos en absoluto, la página lo indica e te indica que hagas un push a una rama para comenzar.
Cuál vista abrir
- Una compilación es lenta. Build Insights, en el proyecto. Mira p50 contra p95, luego tiempo de espera en cola, luego la tabla de compilaciones más lentas.
- Las compilaciones siguen fallando. Build Insights para la tasa, luego la clasificación de causa de fallo de la pestaña Analytics: consulta Orbit Project Analytics.
- Alguien pregunta cómo está entregando el equipo. Insights, en toda la cuenta. Las cuatro métricas DORA con sus flechas de tendencia responden esa pregunta directamente.
- Estás eligiendo en qué trabajar a continuación. Insights primero para encontrar el proyecto, Build Insights segundo para encontrar la causa.
Solución de problemas
La página está vacía pero sé que desplegamos. Amplía la ventana. Build Insights usa por defecto una ventana más corta de lo que podrías esperar, y la página en toda la cuenta es fija en 30 días.
La tasa de aciertos de caché es cero. O el caché fue borrado recientemente, o tu plan no incluye almacenamiento en caché de compilaciones. Consulta Orbit Plan Limits.
Lead time se ve enorme. Lead time se mide desde confirmación hasta producción, así que una rama de larga duración que se fusionó semanas después de su primer confirmación lo infla. Esa es información real, no un error: te está diciendo que el trabajo está sin fusionar.
MTTR está en blanco. No ha habido fallos de producción en la ventana, así que no hay nada de lo que recuperarse. Ese es el caso bueno.
A dónde ir a continuación
- Orbit Project Analytics para la imagen más completa por proyecto.
- Troubleshooting Failed Builds una vez que sepas cuáles compilaciones fallan.
- Orbit Deployment Pipeline para las puertas que se encuentran entre una confirmación y producción.