Ir al contenido

Depurar un micro que no arranca

Un micro no siempre falla igual. La clave: un micro que no llega a arrancar (comando mal, repo ausente, puerto ocupado) no escribe ni una línea propia —el motivo está en los logs del motor—, y ese es justo el fallo que más despista si solo miras los logs del micro.

Lo más rápido: el diagnóstico del micro reúne en una sola respuesta su estado en runtime, lo que el motor dijo de él, sus errores y su última muestra de métricas. No exige que el escenario siga vivo: diagnosticar después de una caída es el caso normal.

Desde el CLI: microlab diagnose <micro>.

En el dock Logs, filtra por ese micro y por nivel Error. Si no ves nada suyo, mira las fuentes del sistema (engine) — ahí aparece por qué no arrancó.

Desde el CLI:

Ventana de terminal
microlab logs orders-core -n 500 # sus últimas líneas
microlab logs --errors # solo errores, en todo el escenario
microlab logs -g "connection refused" # una pista concreta

Los logs persisten: microlab logs funciona aunque el motor ya no esté vivo.

Muchos fallos de arranque son de entorno (falta una herramienta, una credencial, Docker). El Chequeo de entorno los detecta antes de arrancar.

Si arreglaste algo, no hace falta rearrancar todo el escenario: reinicia solo ese micro (en su tarjeta/fila, o microlab restart <micro>).