Pular para o conteúdo

Depurar um micro que não arranca

Um micro nem sempre falha da mesma forma. A chave: um micro que não chega a arrancar (comando mal, repo ausente, porta ocupada) não escreve uma única linha própria —o motivo está nos logs do motor—, e essa é justamente a falha que mais despista se só olhar para os logs do micro.

O mais rápido: o diagnóstico do micro reúne numa só resposta o seu estado em runtime, o que o motor disse dele, os seus erros e a sua última amostra de métricas. Não exige que o cenário continue vivo: diagnosticar após uma queda é o caso normal.

A partir do CLI: microlab diagnose <micro>.

No dock Logs, filtre por esse micro e por nível Error. Se não vir nada dele, olhe para as fontes do sistema (engine) — aí aparece porque não arrancou.

A partir do CLI:

Ventana de terminal
microlab logs orders-core -n 500 # as suas últimas linhas
microlab logs --errors # só erros, em todo o cenário
microlab logs -g "connection refused" # uma pista concreta

Os logs persistem: microlab logs funciona mesmo que o motor já não esteja vivo.

Muitas falhas de arranque são de ambiente (falta uma ferramenta, uma credencial, Docker). A Verificação do ambiente deteta-as antes de arrancar.

Se corrigiu algo, não é preciso reiniciar todo o cenário: reinicie só esse micro (no seu cartão/linha, ou microlab restart <micro>).