Question: How do you monitor and manage PostgreSQL replication slot lag?


PostgreSQL replication slots are a feature introduced in version 9.4 to ensure that a standby server can request the primary to retain WAL segments until they have been safely received and applied, preventing data loss scenarios. However, managing and monitoring replication slot lag is critical because if the standby falls too far behind, it can lead to disk space issues on the primary due to accumulated WAL files.

Monitoring Replication Slot Lag

The lag of a replication slot can be measured as the difference between the current WAL location on the primary and the last WAL position confirmed as received by the standby. You can use the following SQL query on the primary server to monitor the replication slot lag:

SELECT slot_name, pg_size_pretty(pg_current_wal_lsn() - restart_lsn) AS replication_slot_lag, active FROM pg_replication_slots;

This query will list all replication slots along with their lag size in a human-readable format (pg_size_pretty) and indicate whether the slot is currently active. The restart_lsn column represents the last WAL position known to be received by the standby.

Managing Replication Slot Lag

  1. Monitoring Disk Space: Regularly check the disk space where WAL segments are stored. If replication slots cause your disk to fill up, consider increasing the disk size or reducing the retention period for other data that is less critical.

  2. Configure WAL Retention Policies: Use parameters like wal_keep_segments to specify the minimum number of WAL files to keep, but be cautious as setting this too high can consume a lot of disk space.

  3. Standby Server Maintenance: Ensure that the standby server(s) are catching up correctly. Issues such as network latency or heavy load on the standby can increase the lag. Address these issues to ensure smooth replication.

  4. Vacuum and Maintenance: Regular maintenance tasks like vacuuming can help in ensuring that the database performance is optimal, which indirectly helps in maintaining a minimal replication lag.

  5. Slot Configuration: Periodically review your replication slot configuration. If a replication slot is no longer needed (for example, if a standby server has been decommissioned), make sure to drop it to avoid unnecessary WAL file retention.


Managing replication slot lag in PostgreSQL requires a proactive approach to monitoring and system administration. By keeping an eye on the replication slots' lag and ensuring your system is appropriately configured, you can prevent disk space issues and ensure high availability and data consistency across your replicated databases.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.