pgbadger

Análise de logs para descoberta de consultas lentas no PostgreSQL 18.4 - transforme a saída de log_min_duration_statement em relatórios classificados que alimentam a revisão de EXPLAIN e tickets de design de índice.

Receita

ALTER SYSTEM SET log_destination = 'csvlog';
ALTER SYSTEM SET logging_collector = on;
ALTER SYSTEM SET log_min_duration_statement = '250ms';
ALTER SYSTEM SET log_statement = 'none';
ALTER SYSTEM SET log_line_prefix = '%t [%p]: user=%u,db=%d,app=%a,client=%h ';
SELECT pg_reload_conf();

pgbadger /var/log/postgresql/postgresql-18-main.csv \
  -o /var/reports/pgbadger/$(date +%F) \
  --incremental \
  --exclude-query="^(BEGIN|COMMIT|SET|SHOW)"

Quando usar isso:

• Revisão semanal de consultas lentas sem habilitar log_statement = all completo
• Tendência histórica: "a implantação X regrediu o tempo de consulta p95?"
• Equipes sem orçamento para pganalyze ainda precisam de listas de consultas acionáveis

Exemplo de Trabalho

Passo 1 - Coletar um dia de logs

sudo ls -la /var/log/postgresql/
# postgresql-18-main.csv, postgresql-18-main.csv.1, ...

Passo 2 - Gerar relatório

OUT=/var/reports/pgbadger/2026-07-09
mkdir -p "$OUT"
pgbadger /var/log/postgresql/postgresql-18-main.csv* \
  -o "$OUT" \
  --jobs=4 \
  --top=50

Passo 3 - Triar a consulta principal

-- Copie a consulta normalizada do relatório para o psql
EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
SELECT o.id, o.total
FROM orders o
WHERE o.tenant_id = $1 AND o.status = 'open'
ORDER BY o.created_at DESC
LIMIT 50;

O que isso demonstra:

• pgbadger classifica por tempo total e contagem de chamadas
• Relatórios vinculam a duração ao aplicativo app=%a quando log_line_prefix inclui %a
• Evidências de EXPLAIN fecham o ciclo do log para a correção do plano

Mergulho Profundo

Tabela de Configurações de Log

Relatórios Incrementais

pgbadger --incremental --report-per-database \
  --outdir /var/reports/pgbadger/incr \
  /var/log/postgresql/postgresql-18-main.csv

• O arquivo de estado incremental evita o reprocessamento de terabytes mensalmente
• Relatórios por banco de dados ajudam equipes de operações multilocatárias

Alternativa jq para Uso Único

grep "duration:" /var/log/postgresql/postgresql-18-main.csv \
  | awk -F'duration: ' '{print $2}' | sort -rn | head -20

• Triagem rápida via SSH antes da execução completa do pgbadger durante incidentes

Armadilhas

• Incompatibilidade do formato de log JSON - pgbadger espera CSV ou texto padrão, não apenas jsonlog sem conversão. Correção: use csvlog ou verifique se a versão do pgbadger suporta seu formato.
• Registrar todas as instruções - disco enche, IO colapsa. Correção: log_min_duration_statement baseado em limite.
• PII no texto da consulta - logs capturam literais de vinculação em algumas configurações. Correção: log_parameter_max_length=0 ou redigir relatórios.
• Confusão de fuso horário - %t vs UTC. Correção: alinhe log_timezone com as ferramentas de incidentes.
• Ignorando o contexto de cache atingido - uma consulta lenta pode ser de cache frio. Correção: correlacione com o tempo médio vs. máximo do pg_stat_statements.

Alternativas

FAQs

Relacionados

• Noções Básicas de Ferramentas - configuração de envio de logs
• Noções Básicas de Logging - configuração do coletor
• CSVlog e Logs JSON - escolha de formato
• Noções Básicas de EXPLAIN - revisão de plano após triagem
• pganalyze / OtterTune - alternativa SaaS

Versões da Pilha: Esta página foi escrita para PostgreSQL 18.4 e pgBadger 12.4+.