Skip to main content
View rawEdit

05. Backups and DR

Monitor backup status, WAL archiving, and disaster recovery readiness.

note

This dashboard requires WAL archiving to be configured (pgBackRest, WAL-G, or similar). Without backup tools configured, panels will show "No data".

Purpose​

Track backup health to ensure:

  • Backups complete successfully
  • WAL archiving keeps pace with generation
  • Recovery point objectives (RPO) are met

When to use​

  • Daily backup verification
  • Investigating failed backups
  • Capacity planning for backup storage
  • Validating DR readiness

Key panels​

WAL archiving status​

What it shows:

  • WAL files waiting to be archived
  • Archive success/failure rate
  • Archive lag time

Healthy state:

  • ready_count near 0 (no backlog)
  • Consistent archive rate matching WAL generation

Warning signs:

  • Growing ready_count = archiving falling behind
  • Archive failures = storage or network issues

Last backup age​

What it shows:

  • Time since last successful backup
  • Backup duration trend

Healthy range:

  • Within your backup schedule (e.g., < 24h for daily backups)

WAL generation rate​

What it shows:

  • WAL bytes generated per second
  • Helps size archive storage and bandwidth

Checkpoint activity​

What it shows:

  • Checkpoint frequency and duration
  • Checkpoint write/sync times

Healthy state:

  • Checkpoints completing within checkpoint_timeout
  • No checkpoint warnings in logs

Variables​

VariablePurpose
cluster_nameCluster filter
node_nameNode filter

Backup tools integration​

This dashboard monitors PostgreSQL-level metrics. For tool-specific monitoring:

ToolWhat to monitor
pg_basebackupBackup completion time, size
pgBackRestStanza status, backup retention
BarmanServer status, backup catalog
WAL-GBackup list, WAL archive status

Troubleshooting​

WAL archive backlog growing​

  1. Check archive command status:

    select * from pg_stat_archiver;
  2. Verify archive destination has space

  3. Check archive command in postgresql.conf:

    show archive_command;

No backup metrics​

Ensure your backup tool exposes metrics that pgwatch can collect, or configure custom metrics for your backup solution.