Skip to content

docs: add continuous backup events for Point-in-Time Recovery (PiTR) #3758

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
curzolapierre wants to merge 1 commit into
base: master
Choose a base branch
from
+32 −0
Draft

docs: add continuous backup events for Point-in-Time Recovery (PiTR) #3758

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions src/_posts/databases/about/2000-01-01-backup-policies.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,15 @@ The following events are available to monitor the backups:
| `database_backup_succeeded` | A database backup has been successfully completed |
| `database_backup_failed` | A database backup has failed |

The following events are available to monitor continuous backups for Point-in-Time
Recovery (PiTR):

| Event | Description |
| ----------------------------------- | ----------- |
| `database_continuousbackup_healthy` | Point-in-time recovery is available and restore points are up to date |
| `database_continuousbackup_delayed` | The latest restorable point is more than 12 hours behind |
| `database_continuousbackup_stale` | The latest restorable point is more than 24 hours behind |

To learn more about events and notifiers, please visit the page dedicated to [app notifiers]({% post_url platform/app/2000-01-01-notifiers %}).

## Restoring a backup
Expand Down
3 changes: 3 additions & 0 deletions src/_posts/platform/app/2000-01-01-notifiers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,9 @@ Keep the rows sorted alphabetically by name.
| `collaborator_role_changed` | Collaborator role changed | A collaborator role was changed |
| `database_backup_failed` | Database backup failed | A database backup has failed |
| `database_backup_succeeded` | Database backup succeeded | A database backup has succeeded |
| `database_continuousbackup_delayed` | Database continuous backup delayed | The latest restorable point is more than 12 hours behind |
| `database_continuousbackup_healthy` | Database continuous backup healthy | Point-in-time recovery is available and restore points are up to date |
| `database_continuousbackup_stale` | Database continuous backup stale | The latest restorable point is more than 24 hours behind |
| `database_maintenance_completed` | Addon maintenance completed | A maintenance has been completed successfully on your addon |
| `database_maintenance_planned` | Addon maintenance planned | A maintenance is planned on your addon |
| `database_maintenance_started` | Addon maintenance started | A maintenance has started on your addon |
Expand Down
20 changes: 20 additions & 0 deletions src/changelog/api/_posts/2026-05-22-continuous_backup_events.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
modified_at: 2026-05-22 10:00:00
title: "New Database Continuous Backup Events"
---

Three new event types have been added to monitor continuous backups for
Point-in-Time Recovery (PiTR):

- `database_continuousbackup_healthy`: Point-in-time recovery is available and
restore points are up to date
- `database_continuousbackup_delayed`: The latest restorable point is more than
12 hours behind
- `database_continuousbackup_stale`: The latest restorable point is more than
24 hours behind

These events can be used to create notifiers that alert you when continuous
backup health changes.

More information about events and notifiers in the
[documentation]({% post_url platform/app/2000-01-01-notifiers %}).