Skip to content

feat: log seeder shutdown timings for deploy measurement - #729

Merged
rodrigopavezi merged 1 commit into
mainfrom
feat/seeder-shutdown-timing
Nov 17, 2026
Merged

rodrigopavezi merged 1 commit into
mainfrom
feat/seeder-shutdown-timing

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Primeira etapa da fase B (implantação do semeador sem porta escura): só medição, sem mudança de comportamento.

  • os eventos ws e ready do log JSON de seed ganham at (instante absoluto em ms desde 1970);
  • ao desligar, o novo evento stopped traz drainMs (do sinal ao fim do drain do WebSocket), closeMs (do sinal ao armazenamento fechado; fatal: true no lugar dele depois de um fechamento fatal) e stopListeningAt (só com --ws-port);
  • sem --json, o desligamento imprime a linha stopped.

Com uma implantação em produção: tempo de fechamento C = closeMs do processo antigo; porta sem escuta = ws.at do novo menos stopListeningAt do antigo. Esses números decidem se as etapas seguintes (semeador reserva no mesmo diretório) são necessárias.

Limites conhecidos (detalhes em docs/verification/feat-seeder-shutdown-timing.md): uma implantação não é uma distribuição; a porta escura precisa dos logs dos dois contêineres; um SIGTERM antes de seed ready superestima C; o caminho fatal não tem teste próprio.

Issue

Closes # (não há issue aberta para este problema)

Como verificar

node apps/cli/test/seed-shutdown-timing.test.js
node apps/cli/test/seed-ws-drain.test.js
node packages/core/test/seeder-start-timing.test.js
node apps/cli/test/seed-ops.test.js

Checklist

  • npm run lint, npm test (ou npm test -- --affected=origin/main) e npm run demo passam
  • docs/protocol.md ou docs/rpc.md atualizados, se um formato mudou
  • Entrada do changelog em docs/changelog/<branch>.md e verificação em docs/verification/<branch>.md, se houver, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR
  • Conferido no Android (emulador ou aparelho) e no simulador iOS antes da web/PWA, ou explicado por que não se aplica: não se aplica; a mudança é só no log do semeador
  • Nenhum segredo, chave ou dado pessoal no diff

The seeder's JSON log now carries an absolute `at` on `ws` and `ready`,
and a `stopped` event at shutdown with drainMs, closeMs (or fatal: true
after a self-close) and stopListeningAt (only with --ws-port). One
production deploy then gives the close time and the time the WebSocket
port was dark, which decides whether the standby handoff is needed.

No behaviour change: shutdown order and exit codes are unchanged.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 07:49
@rodrigopavezi
rodrigopavezi merged commit be7c917 into main Nov 17, 2026
24 checks passed
@rodrigopavezi
rodrigopavezi deleted the feat/seeder-shutdown-timing branch November 17, 2026 08:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant