xataio/pgstream

Add phase visibility for `snapshot_and_replication` mode

Fechada

#984 aberto em 9 de jul. de 2026

Ver no GitHubGuia do colaborador
 (1 comentário) (1 reação) (0 responsável)Go (66 forks)auto 404
good first issuereplicationsnapshot

Métricas do repositório

Stars
 (1.151 estrelas)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

Problem

In snapshot_and_replication mode, there's no queryable way to tell whether the process is doing the initial snapshot or logical replication. The only signal is the ordered log sequence: initial snapshot enabled → snapshot generation completed → logical replication started.

pgstream status doesn't help: it's a static config/init check against Postgres (not the running process), and its Status struct has no phase field.

Proposal

Expose the current phase (snapshot | replication) as a queryable signal. Preferred: a /status endpoint on the existing health server (cmd/health_cmd.go:32), and OTel phase gauge, or enriching pgstream status to read slot active/confirmed_flush_lsn.

Requirements

  • Operator can tell snapshot vs streaming phase without reading logs.
  • Signal flips at logical replication started.
  • Works for all pgstream modes, not just snapshot_and_replication

Guia do colaborador

Direção de pesquisa
Explore o servidor de saúde existente em cmd/health cmd.go e o comando pgstream status. Determine como expor a fase atual (snapshot ou replicação) por meio de um endpoint /status ou um medidor de fase OTel. Garanta que o sinal mude quando a replicação lógica for iniciada.
Pilha de tecnologia
go
Domain
backenddatabase
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GoPostgreSQL
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
50