diagnose-with-must-gather

Collects and analyzes OADP must-gather diagnostic data to identify issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Collects and analyzes diagnostic data for OADP using the must-gather tool to troubleshoot backup, restore, and deployment issues.

Core Features & Use Cases

  • Collects must-gather data to diagnose OADP problems across operator, backup, restore, and deployment components.
  • Analyzes must-gather artifacts (operator logs, Velero logs, DPA configuration, backups/restores) to identify common failure patterns.
  • Generates remediation guidance and actionable steps to resolve issues and prepare support cases.

Quick Start

Run oc adm must-gather with the latest oadp-must-gather image to collect diagnostics and review the output for issues.

Frequently Asked Questions about diagnose-with-must-gather

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

FAQPage Schema
How do I diagnose OADP backup and restore failures on an OpenShift cluster?

Diagnosing OADP backup and restore failures involves using the must-gather tool to collect and analyze operator, Velero, and DPA logs. It identifies failure patterns and generates a structured report with actionable remediation steps.

What is the best way to troubleshoot OADP deployment issues using must-gather?

The best way to troubleshoot OADP deployment issues is by running must-gather to collect diagnostic data. It analyzes Velero and operator logs to identify failure patterns and provides structured, actionable remediation guidance.

When do I need to run must-gather for OADP on OpenShift?

You need to run must-gather when experiencing backup, restore, or deployment failures on an OpenShift cluster. It collects diagnostic data to pinpoint issues and generates actionable steps for remediation and support case preparation.

Can I use must-gather to analyze Velero logs for OADP configuration problems?

Yes, must-gather analyzes Velero logs and DPA configurations to identify OADP problems. It collects these artifacts to pinpoint common failure patterns and documents configuration checks alongside actionable remediation steps.

What prerequisites are required to collect OADP must-gather diagnostics?

Prerequisites for collecting OADP must-gather diagnostics include access to an OpenShift cluster and the latest oadp-must-gather image. Running oc adm must-gather collects the data needed to review and troubleshoot operator and backup issues.

Why does my OADP backup fail and how does must-gather help identify the cause?

OADP backups can fail due to operator, Velero, or DPA configuration issues. Must-gather helps identify the exact cause by collecting and analyzing these logs to pinpoint failure patterns and generate actionable remediation guidance.