Análisis de compilaciones de Elixir
El paquete Hex de Tuist puede enviar análisis de compilación a Tuist. Los tiempos de compilación, el grafo de dependencias entre tus archivos y cómo ambos evolucionan con el tiempo te dan lo que necesitas para optimizar tu grafo de compilación y aprovechar al máximo todos los núcleos disponibles en el entorno donde se realiza la compilación.
- Completa Comenzar con Elixir
Informa sobre tus compilaciones#
La configuración compartida instala la integración de compilación. Sigue usando tus comandos habituales:
mix compile
La integración cubre mix compile y cada compilación que otra tarea desencadene, como mix test o mix phx.server. Una compilación que no encuentra nada que hacer no se informa, por lo que el panel solo enumera las compilaciones que realizaron trabajo.
Informa sobre la reclamación del actor#
Las solicitudes de informe de compilación y prueba de Mix incluyen la cabecera opcional x-tuist-actor-id solo cuando configuras explícitamente una etiqueta. Establece TUIST_ACTOR_ID en una etiqueta con alcance de organización o añade actor_id: "developer-label" a la configuración tuist del proyecto. La resolución prefiere la variable de entorno, luego las opciones de tiempo de ejecución :actor_id y después la configuración del proyecto. Por defecto no se envía ninguna etiqueta y el paquete no detecta nombres de usuario del sistema operativo. Una etiqueta fija del proyecto se aplica a todos los que usen esa configuración. Las anulaciones vacías o inválidas omiten la reclamación en lugar de recurrir a un respaldo; esto no elimina la identidad verificada basada en credenciales. Si un proxy personalizado rechaza cabeceras desconocidas, opta por no participar con TUIST_ACTOR_ID="".
Los identificadores deben ser de 1 a 128 bytes de ASCII imprimible sin espacios. Las anulaciones inválidas se omiten sin recurrir a un respaldo. Las credenciales individuales verificadas tienen prioridad; otros identificadores reportados por el cliente se muestran como No verificado, nunca autorizan el acceso y nunca se vinculan automáticamente a usuarios. Cualquiera que pueda ver los informes del proyecto puede ver estos identificadores, incluidos los espectadores públicos cuando el proyecto es público, y se incluyen en las exportaciones de datos, así que no incluyas secretos. Los servidores antiguos ignoran la cabecera opcional y los nuevos servidores aceptan clientes antiguos sin ella. Los nuevos informes con token compartido sin identificador muestran Desconocido, en lugar de la organización publicadora; los informes históricos conservan su atribución anterior. Los informes de compilación y prueba requieren autenticación por defecto. Las instalaciones autoalojadas pueden habilitar explícitamente los informes sin credenciales como se describe a continuación.
Informes sin credenciales en una red privada#
Después de que un operador configure TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS=true en la instancia y la reinicie como se describe en la guía de autoalojamiento, configura tu destino. El SDK descubre automáticamente si la instancia permite informes sin credenciales cuando estas están ausentes. La configuración de la instancia cubre todos los proyectos compatibles y no tiene ningún interruptor en el panel:
tuist: [
url: "https://tuist.internal.example",
project: "account/project"
]
mix tuist.compile y mix tuist.test publican informes estructurados sin iniciar sesión cuando las credenciales están realmente ausentes y el descubrimiento confirma que el servidor lo permite. No se requiere ninguna bandera del cliente ni participación explícita del proyecto. Las credenciales presentes, incluida la identidad OIDC de CI suministrada, se utilizan o se rechazan, pero nunca se ignoran para degradar a informes sin firmar. Un TUIST_TOKEN que solo contenga espacios en blanco es un error. Un TUIST_TOKEN vacío puede recurrir a credenciales almacenadas válidas u OIDC suministrado, y las credenciales almacenadas obsoletas pueden recurrir a OIDC suministrado; ambas rutas permanecen autenticadas y nunca habilitan informes sin firmar. Las credenciales inutilizables se conservan y fallan cuando ningún respaldo autenticado tiene éxito. Actualiza cada réplica del servidor a una versión compatible con el descubrimiento antes de actualizar los clientes sin credenciales; los servidores antiguos sin descubrimiento, las instancias deshabilitadas y los fallos de descubrimiento aún requieren autenticación.
Las ejecuciones sin firmar son telemetría, no evidencia confiable de inestabilidad, cuarentena, cobertura o ejecución selectiva. La planificación de fragmentos, los archivos de compilación y los puntos finales de cobertura/artefactos aún requieren credenciales. Establece TUIST_ACTOR_ID="" de forma independiente para omitir la reclamación del actor configurada; la identidad de credencial verificada no se ve afectada.
Qué se rastrea#
Para cada compilación, el paquete recopila:
- Su duración, si tuvo éxito y el entorno de Elixir, Erlang/OTP y Mix con el que se ejecutó
- Cada advertencia y error, con su archivo y línea
- Cuánto tardó en compilarse cada archivo y los módulos que define
- Los archivos de los que depende cada archivo y si los necesita en tiempo de compilación o solo en tiempo de ejecución
- Lo que hizo la compilación además de compilar archivos, como la comprobación de tipos, la escritura en disco y los otros compiladores de Mix
- El uso de procesador, memoria, red y disco de la máquina durante la compilación
- La rama y la confirmación, y en integración continua, el proveedor y la ejecución
Encuentra qué ralentiza una compilación#
Abre una compilación desde Compilaciones → Ejecuciones de compilación en el panel. Las compilaciones, sus recuentos de diagnósticos y sus resúmenes de caché de dependencias también están disponibles a través de tuist build mix list y tuist build mix show, GET /api/projects/{account_handle}/{project_handle}/mix/builds, y las herramientas list_mix_builds y get_mix_build de MCP.
La pestaña Resumen enumera los archivos que compiló la compilación. Puedes agruparlos por módulo, buscarlos y ordenarlos por:
- Duración de compilación, para encontrar los archivos que son lentos por sí mismos.
- Dependientes en tiempo de compilación, el número de archivos que no pueden compilarse hasta que este lo haga. Un archivo lento con muchos dependientes retrasa el resto de la compilación y cambiarlo recompila todos ellos.
- Dependencias en tiempo de compilación, el número de archivos por los que este espera.

La pestaña Línea de tiempo muestra la misma compilación a lo largo del tiempo: qué archivos se compilaron en paralelo, dónde la compilación realizó la comprobación de tipos y escribió en disco, y cómo estaba la máquina en cada momento. Un tramo con una sola barra es un tramo en el que la compilación no pudo usar los núcleos que tenía.

Las pestañas Advertencias y Errores enumeran los diagnósticos de la compilación.
Metadatos personalizados#
Adjunta etiquetas y datos clave-valor a las compilaciones de Mix para distinguir ejecuciones de diferentes equipos, hardware o flujos de trabajo. Ambos aparecen en la página de detalles de cada compilación.
Establece metadatos con variables de entorno:
export TUIST_TAGS="nightly,release"
export TUIST_VALUES="ticket=TUIST-123,runner=linux-arm64"
También puedes configurar metadatos en mix.exs:
tuist: [
project: "account/project",
tags: ["nightly", "release"],
values: %{"ticket" => "TUIST-123", "runner" => "linux-arm64"}
]
Las etiquetas de ambos lugares se combinan. Cuando la misma clave está configurada en ambos lugares, el valor de la variable de entorno tiene prioridad.
Las etiquetas solo pueden contener letras, números, guiones y guiones bajos. Una compilación puede tener hasta 50 etiquetas y cada etiqueta puede contener hasta 50 caracteres. Una compilación puede tener hasta 20 entradas clave-valor; cada clave puede contener hasta 50 caracteres y cada valor puede contener hasta 500 caracteres. Estos son los mismos límites del servidor que se usan para los metadatos de compilaciones de Xcode. El paquete omite las etiquetas no válidas y las entradas de metadatos demasiado grandes o vacías antes de enviar el informe, por lo que una configuración no válida no impide que se almacene el resto del informe de análisis de compilaciones. Usa metadatos clave-valor para los valores que no cumplan la restricción de etiquetas.
Los metadatos personalizados se adjuntan a las compilaciones, no a las ejecuciones de pruebas.
Los metadatos personalizados son visibles para los miembros del proyecto en el panel. No los uses para credenciales, tokens de acceso u otros datos sensibles. Tuist conserva los datos de compilación de Mix, incluidos estos metadatos, durante 90 días. Consulta la política de retención de datos para más detalles.
Solución de problemas#
El envío de informes nunca cambia el resultado de tu compilación: si el informe no se puede enviar, la compilación finaliza como lo habría hecho y no se imprime nada. Para ver por qué no se envió un informe, establece TUIST_DEBUG=1:
TUIST_DEBUG=1 mix compile --force