Health Check Pattern

Expõe três probes com perguntas diferentes: /live (o processo travou?), /ready (consegue atender tráfego agora?) e /health (como estão todas as dependências?). O orquestrador reinicia só pelo /live e tira do balanceamento só pelo /ready, então uma dependência lenta nunca reinicia o serviço.

passos: 6
arquivos: 7
teste: 1
tecnologias: 5

Infraestrutura realTypeScriptBunElysiaPostgreSQLDocker

Cenário Relações Comparar

Baixar cartão

Cenário

Um serviço de pagamentos depende do PostgreSQL de contas — sem ele não processa nada — e de um serviço de antifraude, sem o qual funciona pior. O Kubernetes consulta os probes a cada poucos segundos. O demo derruba o antifraude e mostra /health degradado enquanto /ready continua 200.

Planta

Sequência

9/9

9 passos — reproduza para seguir o fluxo

chamada
resposta ou assíncrono
falha
passo
toque num participante para focar
Outras plantas de sequência

Como funciona

6 passos

Endpoint expõe se o serviço responde.

Esconde cada passo: lembre antes de tocar para revelar.

Vocabulário compartilhado

/health+6

/ready+2

degraded+2

/live+1

Health Check

01
Criticidade declaradaPostgreSQL é critical (falha → 503); antifraude é degradada (falha → 207)
02
/live responde sem tocar dependência: banco lento não pode reiniciar o pod
03
/ready consulta só as críticas, com timeout de 5 s por check
04
/health consulta todas, com timeout de 10 s por check, e agrega critical > degraded > ok
05
Reuso de clienteO check do banco usa o pool Bun.sql já aberto, nunca uma conexão nova
06
Cache de 5 sProbes repetidos não viram uma query nova a cada chamada numa dependência já degradada

apps/patterns/health-check-pattern

7 arquivos

src/

controller_health.tsPlugin Elysia com /live, /ready, /health, timeout por check e cache do relatório
api_payment.tsServiço de pagamentos (porta 7030) com os checks de PostgreSQL e antifraude
api_fraud.tsAntifraude (porta 7031) com PUT /mode up, down ou slow
config_payment.tsLê e valida PAYMENT_DATABASE_URL e PAYMENT_FRAUD_URL no boot
demo.tsdemoSobe os dois processos e consulta os probes antes e depois de derrubar o antifraude
controller_health.test.tstesteIntegração com PostgreSQL real: 207, 503, timeout de check travado e cache