This is a cache of https://docs.okd.io/latest/backup_and_restore/application_backup_and_restore/troubleshooting/troubleshooting.html. It is a snapshot of the page at 2026-06-02T19:27:14.437+0000.
Troubleshooting OADP - OADP Application backup and restore | Backup and restore | OKD 4
  1. Documentation
×

Troubleshooting

Table of Contents

Troubleshoot OpenShift API for Data Protection (OADP) issues by using diagnostic tools such as the Velero CLI, webhooks, must-gather custom resource, and other methods. This helps you identify and resolve problems with backup and restore operations.

You can troubleshoot OADP issues by using the following methods:

  • Debug Velero custom resources (CRs) by using the OpenShift CLI tool or the Velero CLI tool. The Velero CLI tool provides more detailed logs and information.

  • Debug Velero or Restic pod crashes, which are caused due to a lack of memory or CPU.

  • Debug issues with Velero and admission webhooks.

  • Check OADP installation issues, OADP Operator issues, backup and restore CR issues, and Restic issues.

  • Use the available OADP timeouts to reduce errors, retries, or failures.

  • Run the DataProtectionTest (DPT) custom resource to verify your backup storage bucket configuration and check the CSI snapshot readiness for persistent volume claims.

  • Collect logs and CR information by using the must-gather tool.

  • Monitor and analyze the workload performance with the help of OADP monitoring.

Additional resources