# runner health

Executa o probe de health check de uma instancia de app e exibe o resultado com tempo de resposta.

Use quando: precisa confirmar se uma instancia esta respondendo apos um deploy ou durante investigacao de incidente. Veja Sistema de Health Check.

# Sintaxe

runner health <app> [flags]

# Flags

# Exemplo

$ runner health meu-app
app:       meu-app
instance:  production
status:    healthy
http:      200 OK
latency:   43ms
checked:   2026-05-27T14:32:01Z

Verificando uma instancia especifica:

$ runner health meu-app -i staging
app:       meu-app
instance:  staging
status:    healthy
http:      200 OK
latency:   61ms
checked:   2026-05-27T14:32:08Z

Saida em JSON para automacao:

runner health meu-app --output json

# Erros comuns

• app not found → o nome ou caminho informado nao corresponde a nenhuma app registrada; confirme com runner list.
• instance not found → a instancia nao existe para o projeto; use runner instances <app> para listar as instancais disponiveis.
• health check failed: connection refused → o container nao esta rodando ou a porta nao esta acessivel; veja Sistema de Health Check para diagnostico.
• health check failed: timeout → o container esta rodando mas nao respondeu dentro do prazo; verifique docker logs do container e revise o healthcheck.timeout no .deploy.yml.