Registros, métricas y solución de problemas

Empieza por la etapa que falla: sincronización del código fuente, compilación, inicio, enrutamiento o una solicitud a la aplicación. Los registros de compilación y de ejecución responden a preguntas distintas.

Leer registros

Abre los Registros o Observabilidad del panel, o utiliza la CLI desde el proyecto local vinculado:

adios logs --build
adios logs --runtime --lines 100
adios logs --runtime --follow
adios logs --http
adios logs --errors

Usa --build-id YOUR_BUILD_ID para inspeccionar una compilación concreta. Usa --region o --replica para filtrar la salida de ejecución cuando haya varias instancias en marcha. Detén una transmisión de registros en vivo con Ctrl+C.

Diagnosticar un despliegue fallido

Síntoma	Primeras comprobaciones
La instalación o compilación de dependencia falla	Registro de compilación, archivo de bloqueo, versión de ejecución, comando de compilación y credenciales de dependencias privadas.
La compilación se completa, pero falla el inicio	Comando de inicio, ruta de salida, variables de entorno necesarias y registro de ejecución.
Falla la comprobación de estado	Puerto configurado, interfaz de escucha, ruta de comprobación de estado, código de estado y disponibilidad de la aplicación.
Funciona la URL generada pero falla el dominio personalizado	Verificación de propiedad del dominio, destino DNS, TLS y ruta actual.
La conexión de la base de datos falla	Equipo, nombre de host privado, versión, credenciales, estado del servicio y contexto de región y red.
La vista previa difiere de la producción	Revisión del código fuente, entorno, manifiesto, artefacto de compilación y versión activa.
La tarea de inteligencia artificial está bloqueada	Error de ejecución, conexión del proveedor, modelo seleccionado, fondos y aprobación pendiente.

Comprueba tanto el estado del despliegue solicitado como su URL pública. Una versión anterior en buen estado puede seguir sirviendo tráfico mientras falla una nueva compilación.

Métricas e incidentes

Usa los Observabilidad para inspeccionar la telemetría disponible para esa carga de trabajo y ese intervalo de tiempo. Revisa las unidades mostradas, los tiempos de origen y los huecos antes de comparar solicitudes, CPU, memoria u otras mediciones. Una muestra ausente no es una medición de cero, y un entorno de ejecución detenido puede informar de forma distinta a uno en marcha.

Al investigar un incidente, relaciona el despliegue o el cambio de código fuente con los registros de ejecución y el intervalo afectado. Mantén los secretos y los datos privados de solicitudes fuera de las capturas de pantalla o informes públicos de incidencias.

Compartir pruebas útiles

Registra el equipo, la carga de trabajo, el ID de compilación o ejecución, la región, la hora UTC aproximada, el comando utilizado y la respuesta fallida o el extracto de registro. Incluye el comportamiento esperado y una reproducción mínima. Elimina tokens bearer, contraseñas, cookies y datos personales antes de compartirlos fuera de tu equipo.

Para errores de estado HTTP y paginación de API, consulta Errores de API. Para persistencia y recuperación, consulta almacenamiento.