Skip to main content

Backup And Restore Troubleshooting

Backup and restore failures usually come from cluster credentials, object storage, Velero, or target environment compatibility.

Quick Map

SymptomCheck First
Backup creation failsCluster RBAC, Velero namespace, operator logs
BSL unavailableEndpoint, bucket, credentials, CA, network
Backup is slowPVC size, storage throughput, network, Velero concurrency
Restored pod PendingPVC binding, StorageClass, node resources
ImagePullBackOffRegistry, imagePullSecret, image rewrite
Ingress has no addressIngressClass and target controller

Commands

kubectl get appbackup,apprestore -A
kubectl get events -A --sort-by=.lastTimestamp | tail -100
kubectl -n disaster-system logs deploy/disaster-operator --tail=300
kubectl -n disaster-system logs deploy/disaster-server --tail=300

Velero checks:

kubectl --context prod-a -n velero get backup,restore,backupstoragelocation
kubectl --context prod-a -n velero logs deploy/velero --tail=300

Fix the root cause before using retry.