APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
O nome de serviço representa uma função que pode ter várias instâncias; o ID distingue registos no contexto do nó. Duas instâncias no mesmo nó precisam de IDs próprios, mesmo quando partilham nome. Em VMs, definições podem ser carregadas com o agente, recarregadas ou registadas por CLI e API. Escolhe um método cuja persistência e gestão de configuração sejam claras. Um check TCP testa aceitação de ligação, não execução correta de uma operação de negócio. Um check HTTP bem desenhado pode observar prontidão, mas deve evitar efeitos reais indesejados e dependências que provoquem falhas em cascata. O estado publicado é a evidência do check configurado, não uma garantia universal.
Aplicação guiada
A descoberta acrescenta filtragem e comportamento do consumidor. Com only_passing falso, warning pode continuar nas respostas DNS; critical é excluído na configuração descrita. Prepared queries permitem critérios adicionais e pesquisa remota segundo topologia suportada. Num incidente fictício, a consulta direta já mostra endpoints recuperados, mas o resolver conserva uma resposta negativa. Investiga cache positiva e negativa, TTL, configuração do resolver e reutilização de ligações. Aumentar TTL reduz consultas, mas pode prolongar desatualização. Leituras stale no lado Consul são outra dimensão: permitem resultados de servidores sem líder, sem provar que refletem a última alteração. O runbook deve identificar qual camada devolveu cada resposta.
TCP passa e HTTP devolve 500: o check pode estar correto para o que mede e insuficiente para o serviço.
Armadilhas comuns
Nome como ID único global; warning sempre excluído; TTL zero como prova de aplicação atualizada.
Tópicos relacionados: Descoberta, arquitetura e quorum · Deployment e bootstrap · Mesh, identidade e intentions
Valida o contrato do check e segue a resposta até ao consumidor real.
Referência: Register services and checks · Historical Consul Associate (003), retired 2026-07-15; technical references inspected 2026-09-30