Skip to content
Percona Documentation

List backups

Note

As of version 1.4.0, the pbm list command provides the information only about completed backups. To check for running backups, use the pbm status. For more information, see Percona Backup for MongoDB status.

For Percona Backup for MongoDB version 1.3.4 and earlier, the pbm list command provides the running backup listed with an ‘In progress’ label. When that is absent, the backup is complete.

Use the pbm list command to view all completed backups. 

$ pbm list

The output provides the following information:

  • Backup name
  • Backup type: logical, physical, selective, incremental. Available starting with version 1.7.0
  • The time to which the sharded cluster / non-shared replica set will be returned to after the restore. Available starting with version 1.4.0.
  • If point-in-time recovery is enabled, its status and the valid time ranges for the restore

Sample output

Backup snapshots:
  2023-03-10T10:44:52Z <logical> [restore_to_time: 2023-03-10T10:44:56Z]
  2023-03-10T10:49:20Z <physical> [restore_to_time: 2023-03-10T10:49:23Z]
  2023-03-10T10:50:22Z <incremental> [restore_to_time: 2023-03-10T10:50:25Z]
  2023-03-10T10:51:02Z <incremental> [restore_to_time: 2023-03-10T10:51:04Z]
  2023-03-10T10:57:47Z <incremental> [restore_to_time: 2023-03-10T10:57:49Z]
  2023-03-10T11:04:25Z <incremental> [restore_to_time: 2023-03-10T11:04:27Z]
  2023-03-10T11:05:03Z <logical, selective> [restore_to_time: 2023-03-10T11:05:07Z]

Restore to time

In logical backups, the completion time almost coincides with the backup finish time. To define the completion time, Percona Backup for MongoDB waits for the backup snapshot to finish on all cluster nodes. Then it captures the oplog from the backup start time up to that time.

In physical backups, the completion time is only a few seconds after the backup start time. By holding the $backupCursor open guarantees that the checkpoint data won’t change during the backup, and Percona Backup for MongoDB can define the completion time ahead.

View detailed information about a backup

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert