Preparar uma observação por camada
O guião cria um servidor HTTP em loopback e uma base SQLite temporária que só contém instruções sintéticas. O primeiro pedido valida o caminho funcional normal. Depois, uma flag controlada representa uma dependência indisponível: /health continua a responder 200, enquanto /ready e a operação devolvem 503.
O registo dessa tentativa indica que não houve commit e a consulta encontra zero efeitos. Antes de executar, prevê estes resultados numa tabela com endpoint, etapa, status e critério funcional. A diferença entre sinais é deliberada e ajuda a discutir dashboards que observam apenas o processo.
Os nomes dos endpoints não são normas universais; outra aplicação precisa de documentar o que cada verificação realmente cobre.
Perder a resposta depois do commit
Na fase seguinte, a operação é gravada e o servidor fecha deliberadamente a ligação antes de enviar confirmação. O cliente recebe RemoteDisconnected, mas a consulta à base encontra um efeito. Não se trata de um timeout de rede externa ou de um crash do processo; o ponto de falha é controlado pelo guião.
A rota sem proteção aplica novamente a mesma intenção quando o cliente repete o pedido. A contagem passa de um para dois. Pede ao aluno que explique o resultado sem dizer que a primeira chamada nunca ocorreu.
Num incidente fictício de APS, esta distinção determina se é seguro repetir, se é preciso consultar o consumidor ou se o estado deve continuar explicitamente incerto.
Comparar o contrato de repetição
A rota protegida regista chave e efeito na mesma transação local. Uma repetição com chave e conteúdo iguais recupera o mesmo identificador e devolve replayed=true. Oito chamadas concorrentes produzem uma aplicação e sete replays nesta execução.
A chave, sozinha, não explica tudo: o guião consulta o registo existente sob BEGIN IMMEDIATE e mantém a alteração dentro da mesma base. Se o conteúdo muda, a rota devolve 409; se a chave falta, devolve 400. Estes códigos fazem parte do contrato criado para o exercício.
Não alteres a chave apenas para contornar um conflito sem decidir se existe uma intenção nova. A análise deve preservar a ligação entre o pedido original, as repetições e os efeitos observados.
Reconhecer a fronteira da evidência
No final, a base contém seis efeitos para cinco intenções, porque a rota sem proteção deixou um duplicado. integrity_check devolve ok, mostrando que a verificação estrutural não aplica uma regra de unicidade de negócio que não foi definida.
O laboratório observa pedidos HTTP reais e transações reais, mas num processo e numa base locais. Não implementa autenticação, pagamentos, consenso entre hosts nem uma transação que inclua um sistema externo. A execução termina o servidor, liberta o listener e remove a base temporária.
Guarda o relatório antes de discutir resultados com colegas. Usa as observações para formular critérios de aceitação mais representativos, sem apresentar este servidor de treino como solução pronta para produção.
Ficheiros do exercício
Pacote do exercício incident-runtime, versão 2026-10. Extrai para uma pasta nova e segue o README.pt.md. Os caminhos content/labs dos comandos ficam disponíveis a partir da pasta extraída. Python 3.13 e permissão para abrir servidores HTTP temporários apenas em 127.0.0.1. Usa sockets, threads e ficheiros temporários próprios, sem acesso a serviços ou dados externos.
Descarregar incident-runtime (ZIP)
SHA-256 (ZIP)
ae85aba70fa545fd074a211c94c9a7fad4492f3ae0bdb9e37bb82ef945bf4b00
# Local training only; binds 127.0.0.1 on an ephemeral port.
python3 content/labs/incident-runtime/run.py --output /tmp/dr-incident-observation.json
# Actual recorded runtime: Python 3.13.1, SQLite 3.51.2, Darwin arm64.
# Own temporary database is removed; no real credentials or business effects.O processo responde a /health, mas a operação falha; noutra fase, a operação é gravada e o cliente perde a resposta.
Armadilhas comuns
Tratar um 200 como serviço recuperado, uma ligação fechada como cancelamento ou uma chave isolada como garantia distribuída.
Tópicos relacionados: Diagnóstico e mitigação · Comunicação e passagem para RUN
Separa a resposta recebida do efeito produzido. A decisão de repetir precisa do contrato e do estado observado.
Referências
- Effective Troubleshooting · SRE book chapter 12; rolling online text consulted 2026-10-04
- Monitoring Distributed Systems · SRE book chapter 6; rolling online text consulted 2026-10-04
- Managing Incidents · SRE book chapter 14; rolling online text consulted 2026-10-04
- Incident state document example · SRE book appendix C; organizational example, not a bank policy
- Postmortem Culture · SRE book chapter 15; rolling online text consulted 2026-10-04
- External Communication Guidelines · Rolling organizational guidance consulted 2026-10-04; not a universal SLA
- Making retries safe with idempotent APIs · Malcolm Featonby article consulted 2026-10-04; conceptual source, no AWS API executed
- Python http.server · Python 3.13 rolling docs label 3.13.16; executed CPython 3.13.1; local training server only
- Python sqlite3 transactions · Python 3.13 rolling docs label 3.13.16; executed CPython 3.13.1 and SQLite 3.51.2