diagnose-backup-issues

Diagnose OADP/Velero backup and restore issues in Kubernetes environments.

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/mpryc/ai-agents-and-skills --skill diagnose-backup-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose-backup-issues
Source: https://github.com/mpryc/ai-agents-and-skills/tree/main/claude/oadp-operator/skills/operations/diagnose-backup-issues
Command: npx skills add https://github.com/mpryc/ai-agents-and-skills --skill diagnose-backup-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This diagnostic skill automates comprehensive checks to identify and troubleshoot OADP and Velero backup/restore issues. It aggregates installation status, storage health, network connectivity, RBAC/credentials, and logs to provide concrete remediation steps.

Core Features & Use Cases

  • Environment Health: validates OADP installation, operator status, and essential components.
  • Storage & Config Validation: verifies BackupStorageLocations and Velero config, and checks for correct credentials.
  • Runtime & Logs Analysis: collects logs, pod statuses, and recent events to surface root causes.
  • Restore & Backup Diagnostics: analyzes ongoing and completed backups/restores to detect failures and warnings.
  • Guided Recommendations: offers actionable remediation steps and runbooks for common failure modes.
  • Use Case Example: when backups fail or stall, run diagnostics to get prioritized fixes and validation checks.

Quick Start

Run the diagnose-backup-issues diagnostic to assess OADP/Velero backup health and get actionable remediation guidance.

Frequently Asked Questions about diagnose-backup-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Velero backup failures in Kubernetes?

To troubleshoot Velero backup failures in Kubernetes, run automated diagnostics that validate installation health, storage configurations, and network connectivity. The process analyzes recent events and logs to surface root causes, providing actionable remediation steps for operators.

What is the best way to diagnose OADP restore problems in Kubernetes?

Diagnosing OADP restore problems involves analyzing completed restore workflows to detect failures and warnings. Automated checks validate operator status, RBAC permissions, and storage health, offering guided recommendations and runbooks for common failure modes to resolve issues.

Why does my Velero backup stall and how can I fix it?

Velero backups stall due to network connectivity issues, incorrect storage credentials, or operator degradation. Diagnostic checks aggregate pod statuses and recent events to identify the failure point, delivering concrete remediation guidance to validate and resume workflows.

Does this diagnostic tool check OADP operator status and storage validation?

Yes, the diagnostic tool validates OADP installation status, operator health, and essential components. It verifies BackupStorageLocations, Velero configurations, and credentials to ensure storage validation passes, providing a comprehensive environment health assessment for operators.

How do I validate network connectivity and RBAC credentials for OADP backups?

You validate network connectivity and RBAC credentials for OADP backups by running automated health diagnostics. These checks verify correct credentials, assess network paths, and collect relevant logs to ensure proper configuration and connection for backup operations.