PgPulse

A Rust service/CLI that monitors your primary and read replica.

Local setup

For local environment, spin up the postgres docker containers and Grafana environment including Prometheus via docker-compose.yml

docker-compose up -d

If you just want to run the grafana and prometheus, then you can use the following command:

docker-compose -f docker-compose-grafana.yml up -d

Configuration

Update the file config.yaml file with the connection details of your primary and read replica.

Run the service

Pass the config file as the cli argument:

cargo run -- --config config.yaml

Note: If you are are not using the Local setup via docker-compose, then expose the endpoint http://localhost:8080/metrics as a data source in Grafana to visualize the replication lag and other metrics. (It is already added in the prometheus.yml file for local setup)

Demo

Metrics Endpoint

Grafana Dashboard

References:

• What to Look for if Your PostgreSQL Replication is Lagging
• Practical PostgreSQL Logical Replication: Setting Up an Experimentation Environment Using Docker
• Monitoring a Rust Web Application Using Prometheus and Grafana
• Rust Updates 2025 E4: LazyCell and LazyLock Deep Dive