Aerospike Backup Service 3.2.0 release notes
July 8, 2025 | Download
This release implements a variety of new features and improvements to enhance performance, usability, and reliability. It includes a faster version of the underlying backup library, and two breaking changes.
For additional details about fixes, improvements, and maintenance in this release, see the release page on GitHub.
New features
- A new endpoint
GET /v1/restore/jobs
has been added to retrieve a list of all restore jobs, with options to filter by time range and status. - The
min-part-size
property, previously available only for S3 storage, is now supported for both Azure and GCP storage. This property allows you to configure the minimum size of individual upload chunks. - ABS no longer requires root permissions to run.
- ABS now automatically masks private keys in the logs.
Breaking changes
-
The
namespaces
field in a backup routine entry is now mandatory. Previously, omitting this field would default to backing up all namespaces. In this release, to back up all namespaces, you must explicitly provide an empty list (namespaces: []
). This change prevents accidental backups of all namespaces if the field is forgotten. -
The
bandwidth
field in the restore policy is now specified in MiB/s instead of bytes per second. The minimum value for this property is 8 MiB/s. This aligns its unit with the equivalent property in the backup policy and other Aerospike tools. -
The
partition-list
default value is nownull
instead of0-4095
. Both values have the same effect of backing up all partitions in the cluster.
Prometheus metrics update
New metrics in this release provide enhanced monitoring of backup and restore operations:
aerospike_backup_service_backup_events_total
: Counter for backup events, labeled by routine, type, and outcome.aerospike_backup_service_backup_duration_seconds
: Histogram of backup durations.aerospike_backup_service_last_successful_backup_timestamp
: Gauge for the timestamp of the last successful backup.aerospike_backup_service_restore_in_progress
: Counter for the number of restore processes currently running.
The aerospike_backup_service_restore_progress_pct
metric has been removed as it created a new time series for each
restore job, leading to high cardinality issues in Prometheus.
You can monitor restore progress with the /v1/restore/status/{jobId}
endpoint.