Skip to main content

Troubleshooting

Start from the highest-level user symptom, then drill down into CRD status, operation steps, Events, Velero resources, and logs.

Common Order​

  1. Server API response: reason and message.
  2. Related CRD status and conditions.
  3. DisasterOperation.status.steps.
  4. Kubernetes Events.
  5. Velero Backup and Restore status.
  6. Operator logs.
  7. Remote cluster API connectivity.

Common Issues​

  • Invalid kubeconfig or wrong context.
  • Object storage endpoint unreachable.
  • Private CA not configured.
  • Missing Velero permissions.
  • Target namespace or StorageClass mapping incorrect.
  • Long-running operation interrupted by upgrade.